# 安装

> For the complete documentation index, see [llms.txt](https://simbot.forte.love/llms.txt).

simbot的核心功能由实现了 simbot-api 模块的内容提供。

当前示例使用 `5.0` 的预发布版本 `5.0.0-Alpha2`。 从旧版本升级时，可先阅读 [5.0 更新与迁移](migration-5-0.html)。

## 使用核心库

核心库是最基础的对 simbot-api 的实现模块。

### 准备

准备一个 Kotlin 或 Java 项目。

* 如果是 Java 或 Kotlin/JVM 项目, 请确保 JDK 版本是 JDK11 或以上。

* 如果是 Kotlin 多平台项目, 可参考 [概述](outline.html#multiplatform-targets) 了解支持的平台。

### 安装核心库

Gradle(Kotlin DSL):

```KOTLIN
implementation("love.forte.simbot:simbot-core:5.0.0-Alpha2")
```

如果使用 Java 而不配合使用 Gradle 的 [Kotlin 插件](https://kotlinlang.org/docs/gradle-configure-project.html#apply-the-plugin), 那么你需要指定依赖的后缀为 `-jvm`。

```KOTLIN
implementation("love.forte.simbot:simbot-core-jvm:5.0.0-Alpha2")
```

Gradle(Groovy):

```GROOVY
implementation 'love.forte.simbot:simbot-core:5.0.0-Alpha2'
```

如果使用 Java 而不配合使用 Gradle 的 [Kotlin 插件](https://kotlinlang.org/docs/gradle-configure-project.html#apply-the-plugin), 那么你需要指定依赖的后缀为 `-jvm`。

```GROOVY
implementation 'love.forte.simbot:simbot-core-jvm:5.0.0-Alpha2'
```

Maven:

```XML
<dependency>
    <groupId>love.forte.simbot</groupId>
    <artifactId>simbot-core-jvm</artifactId>
    <version>5.0.0-Alpha2</version>
</dependency>
```

> **Tip:**
> 如果你还不清楚 `simbot-api`、`simbot-core`、组件核心模块和公共库之间的区别， 可以先阅读 [模块一览](module-libraries.html)。

## 使用 Spring Boot

参考 [Spring Boot](spring-boot.html) 了解更多。

## 安装组件库

组件库 是平台功能的主要提供者，是重要的核心概念之一。

前往 [组件库](components-intro.html) 选择、添加你所需的组件库，并可以前往它们各自的手册了解更多信息。

## 使用快照

如果你打算使用某个库的快照版本，你需要配置快照仓库。

Gradle(Kotlin DSL):

```KOTLIN
// 其他配置省略...

// 配置仓库
repositories {
    mavenCentral()
    // 额外添加快照仓库
    maven {
        url = uri("https://oss.sonatype.org/content/repositories/snapshots/")
        mavenContent {
            snapshotsOnly()
        }
    }
}

// 引用依赖
dependencies {
    // 使用快照版本
    implementation("要添加的依赖:name:xxx-SNAPSHOT")
}
```

Gradle(Groovy):

```GROOVY
// 其他配置省略...

// 配置仓库
repositories {
    mavenCentral()
    // 额外添加快照仓库
    maven {
        url = 'https://oss.sonatype.org/content/repositories/snapshots/'
        mavenContent {
            snapshotsOnly()
        }
    }
}

// 引用依赖
dependencies {
    // 使用快照版本
    implementation '要添加的依赖:name:xxx-SNAPSHOT'
}
```

Maven:

```XML
<!-- 其他配置省略... -->

<!-- 配置快照仓库 -->
<repositories>
    <repository>
        <id>sonatype-snapshot</id>
        <name>Sonatype Snapshots Repository</name>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

<!-- 引用依赖 -->
<dependency>
    <groupId>要添加的依赖</groupId>
    <artifactId>name</artifactId>
    <version>xxx-SNAPSHOT</version>
</dependency>
```

快照的版本可以前往 [快照仓库](https://oss.sonatype.org/content/repositories/snapshots/love/forte/simbot/) 根据坐标路径寻找。

比如：[simbot-core 的快照版本列表](https://oss.sonatype.org/content/repositories/snapshots/love/forte/simbot/simbot-core/) 以及它的 [maven-metadata.xml](https://oss.sonatype.org/content/repositories/snapshots/love/forte/simbot/simbot-core/maven-metadata.xml)。