2020-12-31 15:59:59 +08:00
|
|
|
|
# Mirai - Preparations
|
|
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
本章节介绍 Mirai 的 JVM 环境和开发准备工作。预计阅读时间 2 分钟。
|
2021-01-11 21:11:33 +08:00
|
|
|
|
|
2020-12-31 15:59:59 +08:00
|
|
|
|
## JVM 环境要求
|
|
|
|
|
|
|
|
|
|
|
|
- 桌面 JVM：最低 Java 8，但推荐 Java 11（要使用一键启动器，需要 11）
|
|
|
|
|
|
- Android：Android SDK 26+ （Android 8.0，Oreo)
|
|
|
|
|
|
|
|
|
|
|
|
|
2021-01-11 21:11:33 +08:00
|
|
|
|
**但注意不要使用 Oracle JDK**（[原因](https://github.com/mamoe/mirai/discussions/779)），可以使用其他任何 JDK。
|
|
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
> 下载 JDK：
|
|
|
|
|
|
> - 手动下载安装如 [AdoptOpenJDK](https://adoptopenjdk.net/)
|
|
|
|
|
|
> - 自动在 IntelliJ IDEA `Project Structure`(`Ctrl+Shift+Alt+S`) -> `SDKs` -> `+` -> `Download JDK` 下载安装
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
|
|
|
|
|
## 开发的准备工作
|
|
|
|
|
|
|
|
|
|
|
|
### 安装 IDE 插件
|
|
|
|
|
|
|
|
|
|
|
|
推荐使用 [IntelliJ IDEA](https://www.jetbrains.com/idea/) 或 [Android Studio](https://developer.android.com/studio)。Mirai 提供一系列 IntelliJ 插件来提升开发体验。
|
|
|
|
|
|
|
2021-01-11 21:11:33 +08:00
|
|
|
|
- [Kotlin Jvm Blocking Bridge](https://github.com/mamoe/kotlin-jvm-blocking-bridge) ([查看 JetBrains 插件仓库](https://plugins.jetbrains.com/plugin/14816-kotlin-jvm-blocking-bridge) / [点击一键安装](https://plugins.jetbrains.com/embeddable/install/14816))：**帮助 Java 用户调用 Kotlin suspend 函数**
|
|
|
|
|
|
- [Mirai Console IntelliJ](https://github.com/mamoe/mirai-console/tree/master/tools/intellij-plugin) ([查看 JetBrains 插件仓库](https://plugins.jetbrains.com/plugin/15094-mirai-console) / [点击一键安装](https://plugins.jetbrains.com/embeddable/install/15094))：提供 mirai-core 的错误检查和 mirai-console 的插件开发辅助
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
使用 Kotlin 开发也可以不安装插件。
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
使用 Java 或其他语言，请务必安装 Kotlin Jvm Blocking Bridge（[为什么？](KotlinAndJava.md#协程)）。同时请确保 Kotlin 插件是最新版本（在 `Settings -> Plugins` 启用并更新 Kotlin 到最新）。
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:11:33 +08:00
|
|
|
|
*如果你不知道这俩是什么，都安装就对了。*
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:11:33 +08:00
|
|
|
|
## 前置知识
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:11:33 +08:00
|
|
|
|
Kotlin 是[让开发人员更快乐的一门现代编程语言](https://www.kotlincn.net/)，由 [IntelliJ IDEA](https://www.jetbrains.com/idea/) 的开发公司 [JetBrains](https://www.jetbrains.com/) 维护，被 Google 推举为 Android 首选编程语言。
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
使用 Mirai 是一个不错的学习 Kotlin 机会，使用者有兴趣可以在 [官方中文文档](https://www.kotlincn.net/docs/reference/) 学习 Kotlin。
|
2020-12-31 15:59:59 +08:00
|
|
|
|
|
2021-01-11 21:21:15 +08:00
|
|
|
|
Java 开发者如果只希望使用 Mirai 而不学习 Kotlin，也请阅读 [Kotlin 定义对应的 Java 定义](KotlinAndJava.md)（5 分钟）。
|
