Skip to content

guobao2333/MT-Plugin

Repository files navigation

MT Plugin

适用于MT管理器的插件(.mtp),为MT添加更多扩展功能。
Plugins (.mtp) for MT Manager application

Github License

基于官方项目修改而来。虽然最新插件V3版本demo仅发布至gitee仓库,不过我已将代码同步至upstream-v3分支,您可以切换分支查看。

Develop | 开发

Important

部分插件使用v3 beta版本,在MT正式版中可能无法使用,推荐切换至测试版进行开发。

所有插件都放 plugins 这个目录下,要增加新的插件直接丢进去就行了,可以随便复制一个项目内的 模块级配置,不需要动任何 项目级配置

如果不想包含某些插件模块,请将该模块build.gradle文件重命名为其他名字。

Prerequisites | 基本要求

  1. Java 8+ (推荐Java 17+,可以但不推荐更旧版本)

官方推荐 Java 11+

  1. Gradle 8.14 (可选,推荐最新版)

直接运行gradlew脚本则无需提前安装。

  1. Kotlin (可选,但只能使用 dex模式 打包)

Important

项目要求Java 17+是为了使用很多高级特性,通过AGP语法脱糖(dex模式)能够使用java8以上的语法。脱糖相关配置已包含在项目中,无需修改开箱即用。

构建插件后将会自动打包文件到 plugins/<plugin>/build/outputs/mt-plugin/ 这个目录中。

Android Studio

打开项目后等待 Gradle 同步完成后运行 某个插件模块,将会有一个名为 MT Plugin Pusher 的应用程序安装到您的设备上,这时它会自启动并打开MT管理器的插件安装界面,点击安装即可。

Command Line | 命令行

在项目根目录执行 ./gradlew :plugins:PLUGIN:packageReleaseMtpPLUGIN替换为指定插件模块即可打包该插件。

还可以一次性打包所有插件:

./gradlew packageReleaseMtpAll

如果使用termux,你需要先安装JDK:

pkg install openjdk-17

Setup development environment | 设置开发环境

如果你是一个初学者,不知道如何设置插件的开发环境,请看这篇教程。不过由于针对于termux编写,它并不能适用于其他Linux系统,您需要修改或移除其中的termux特有命令和环境路径以适用您的系统。

API development docs | API开发文档

APIv3已经迎来了官方文档,您可以点此前往查看

我们已经为您准备好了一个脚本,它用于快速下载官方插件API的jar包,您可以查看脚本使用教程下载脚本源码

Warning

由于官方文档已上线,我们不会再继续更新该脚本。

Push to device | 推送到设备

其实与Android Studio打包插件类似,只需要手动安装构建好的app并打开,会自动调用mt的插件安装界面,因此还可以在Android Studio之外的其他IDE(甚至命令行)中编译并打包插件。

Contribute | 贡献

  1. 点击上方Fork仓库后,修改或添加你的代码
  2. 点击Pull requests创建新的拉取请求后根据提示进行操作。
  3. 提交合并请求后,接下来请等待代码审查,如果审查结束将会合并代码。

如果合并完成,恭喜你🎉您完成了对本项目的贡献!我们由衷的感谢为每个开源项目做出贡献的人。