客户端提供了完整的Java环境支持,运行标准的Java字节码。
客户端默认使用Java 21启动,你可以使用Java 21编译,当然如果你想要确保仍然使用旧启动器的用户可以使用,也可以使用Java 8编译。
开发工具
推荐使用IntelliJ IDEA或者Eclipse进行开发。
设置SDK和工作区
建议下载Zulu 21为SDK,如果要开发Java 8扩展使用任何JDK 8发行版即可。
准备好Java之后,克隆或下载示例扩展,并导入到IDE中,如果你安装了Git可以使用以下命令克隆:
git clone https://github.com/opai-client/example-extension.git
如果一切顺利Maven会自动完成项目配置,配置完成之后你可以开始编辑代码。
在开始编写之前,请修改示例扩展的包名以及在ExampleExtension.java中的@ExtensionInfo注解中的name。有相当多的用户出于某种目的安装了这个示例扩展,请务必修改这些信息防止冲突。
在进行简单的编辑之后,可以使用IntelliJ IDEA侧栏的Maven菜单中的package命令打包。
打包成功之后JAR会生成在target目录下
将这个JAR文件复制到%appdata%\Opai\extensions文件夹中加载这个扩展。
客户端中可以使用命令
重新加载所有插件,在修改代码之后使用这个命令可以快速测试(需要重新打包)。
对于不重新打包的调试请搜索JDWP(Java Debug Wire Protocol),使用IDE的调试功能。
开发文档
开发文档以Javadoc的形式提供,Ctrl + 右键任何一个API的类名,点击Download Source后可以查看Javadoc(只需要点击一次)
几乎所有方法都有详细的注释,如果要了解某个方法的作用阅读注释即可。