跳转到主要内容
客户端提供了完整的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命令打包。 package 打包成功之后JAR会生成在target目录下 将这个JAR文件复制到%appdata%\Opai\extensions文件夹中加载这个扩展。

调试

客户端中可以使用命令
.extension reload
重新加载所有插件,在修改代码之后使用这个命令可以快速测试(需要重新打包)。 对于不重新打包的调试请搜索JDWP(Java Debug Wire Protocol),使用IDE的调试功能。

开发文档

开发文档以Javadoc的形式提供,Ctrl + 右键任何一个API的类名,点击Download Source后可以查看Javadoc(只需要点击一次) doc doc 几乎所有方法都有详细的注释,如果要了解某个方法的作用阅读注释即可。