使用核心库 | Simple Robot

准备

准备一个 Kotlin 或 Java 项目。

如果是 Java 或 Kotlin/JVM 项目, 请确保 JDK 版本是 JDK11 或以上。
如果是 Kotlin 多平台项目, 可参考概述了解支持的平台。

安装

implementation("love.forte.simbot:simbot-core:4.7.0")

如果使用 Java 而不配合使用 Gradle 的 Kotlin 插件, 那么你需要指定依赖的后缀为 -jvm。

implementation("love.forte.simbot:simbot-core-jvm:4.7.0")

implementation 'love.forte.simbot:simbot-core:4.7.0'

如果使用 Java 而不配合使用 Gradle 的 Kotlin 插件, 那么你需要指定依赖的后缀为 -jvm。

implementation 'love.forte.simbot:simbot-core-jvm:4.7.0'

<dependency>
    <groupId>love.forte.simbot</groupId>
    <artifactId>simbot-core-jvm</artifactId>
    <version>4.7.0</version>
</dependency>

使用

创建 Application

使用 Simple 工厂, 或使用扩展函数 launchSimpleApplication。

val app = launchApplication(Simple) {
    // 配置...
}

// 或

val app = launchSimpleApplication {
    // 配置...
}

app.join() // 挂起直到被关闭

var applicationAsync = Applications.launchApplicationAsync(Simple.INSTANCE, appConfigurer -> {
        // 配置 Application...
       
    });

// 异步结果可转化为 CompletableFuture
var future = applicationAsync.asFuture();
// ...

// 阻塞当前线程直到被关闭
future.join();

var application = Applications.launchApplicationBlocking(Simple.INSTANCE, appConfigurer -> {
        // 配置 Application...

    });
});

// 注册事件处理器、注册bot等

// 阻塞当前线程直到被关闭
application.joinBlocking();

有关 Application 的配置与使用可直接前往参考基本内容-Application 章节, 它里面用于示例的内容就是 simbot-core 的实现 Simple。

安装组件

前往组件库选择你想要使用的组件，或者选择某个/些你想要使用的第三方组件，根据它们的手册安装、配置到你的 Application 中。

运行

执行你的程序入口 main 方法，体验一下吧~