mirai/docs/Preparations.md

58 lines
3.0 KiB
Markdown
Raw Normal View History

2020-12-31 15:59:59 +08:00
# Mirai - Preparations
2021-03-21 11:35:23 +08:00
本章节介绍 Mirai 的 JVM 环境和开发准备工作。
2021-01-11 21:11:33 +08:00
2020-12-31 15:59:59 +08:00
## JVM 环境要求
- 桌面 JVM最低 Java 8但推荐 Java 11要使用一键启动器需要 11
- AndroidAndroid SDK 26+ Android 8.0Oreo)
2022-05-19 20:39:29 +08:00
目前主要使用的自动启动器,[Mirai Console Loader](https://github.com/iTXTech/mirai-console-loader)
MCL 默认安装 JRE 17。但旧版本 MCL 会默认安装 JRE 11。因此 Mirai Console 插件使用 JDK 11
是较合适的。
2020-12-31 15:59:59 +08:00
2021-12-06 20:53:07 +08:00
**但注意不要使用 Oracle JDK**
[原因](https://github.com/mamoe/mirai/discussions/779)),可以使用其他任何 JDK。
2021-01-11 21:11:33 +08:00
2021-03-21 11:35:23 +08:00
> 要下载 JDK
2021-01-11 21:21:15 +08:00
> - 手动下载安装如 [AdoptOpenJDK](https://adoptopenjdk.net/)
> - 自动在 IntelliJ IDEA `Project Structure`(`Ctrl+Shift+Alt+S`) -> `SDKs` -> `+` -> `Download JDK` 下载安装
2020-12-31 15:59:59 +08:00
## 开发的准备工作
### 安装 IDE 插件
2021-12-06 20:53:07 +08:00
[Mirai Console IntelliJ]: /mirai-console/tools/intellij-plugin
[Mirai Console IntelliJ-JB]: https://plugins.jetbrains.com/plugin/15094-mirai-console
2021-12-06 20:53:07 +08:00
2021-01-24 15:05:03 +08:00
[Mirai Console IntelliJ-OK]: https://plugins.jetbrains.com/embeddable/install/15094
2020-12-31 15:59:59 +08:00
2021-01-24 15:05:03 +08:00
<!--[Kotlin Jvm Blocking Bridge]: https://github.com/mamoe/kotlin-jvm-blocking-bridge-->
<!--[Kotlin Jvm Blocking Bridge-JB]: https://plugins.jetbrains.com/plugin/14816-kotlin-jvm-blocking-bridge-->
<!--[Kotlin Jvm Blocking Bridge-OK]: https://plugins.jetbrains.com/embeddable/install/14816-->
2020-12-31 15:59:59 +08:00
2021-12-06 20:53:07 +08:00
推荐使用 [IntelliJ IDEA](https://www.jetbrains.com/idea/)
或 [Android Studio](https://developer.android.com/studio)。Mirai 提供 IDE
插件来提升开发体验。
2020-12-31 15:59:59 +08:00
2021-01-24 15:06:54 +08:00
| 插件名 | 描述 | 一键安装 | JetBrains 插件仓库 |
|:------------------------:|:---------------------------------------------------:|:-----------------------------------:|:----------------------------------:|
| [Mirai Console IntelliJ] | 提供 mirai-core 的错误检查和 mirai-console 的插件开发辅助 | [一键安装][Mirai Console IntelliJ-OK] | [说明页][Mirai Console IntelliJ-JB] |
2020-12-31 15:59:59 +08:00
2021-01-24 15:05:03 +08:00
<!--| [Kotlin Jvm Blocking Bridge] | 帮助 Java 用户调用 Kotlin suspend 函数 | [Kotlin Jvm Blocking Bridge-OK] | [Kotlin Jvm Blocking Bridge-JB] |-->
使用 Kotlin 建议安装 Mirai Console IntelliJ。同时请确保 Kotlin 插件是最新版本(在 `Settings -> Plugins` 启用并更新 Kotlin 到最新)。
2020-12-31 15:59:59 +08:00
2021-01-13 16:07:02 +08:00
### Kotlin
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-13 16:07:02 +08:00
Java 开发者如果只希望使用 Mirai 而不学习 Kotlin也请阅读 [Kotlin 定义对应的 Java 定义](KotlinAndJava.md)5 分钟)。
----
> [回到 Mirai 文档索引](README.md#jvm-平台-mirai-开发)