如何构建AKarin&相关问题的解决方法

[zhenaiwork]

如何构建AKarin&相关问题的解决方法

• AKarin构建

• 相关问题解决方法

AKarin构建

• 注意事项
• 把项目拉到本地
• 把子模块拉到本地
• 开始构建AKarin

1 注意事项

• 需要的软件&简单介绍
• 各软件的安装方法

需要的软件&简单介绍

在构建之前你的电脑要有 GIT , IDEA , openjdk8 , Gradle , Maven.

GIT是有来拉项目和模块有的

IDEA是目前比较常用的开发工具

openjdk 8 是开发环境【必须是8】

Gradle和Maven是构建环境

各软件的安装方法

• GIT
• IDEA
• openjdk 8
• Gradle&Maven

GTI

打开链接可以看到各个系统的安装教程

IDEA

打开链接可以看到各个系统的安装包下载页面。

win&Mac下载对应版本的安装包

Linux(ubuntu) 可以直接运行

sudo snap install intellij-idea-community --classic

openjdk8

win&Mac 打开链接后下拉找到Java8下载对应版本的安装包

Linux(ubuntu) 可以直接运行

sudo apt install openjdk-8-jdk

Gradle & Maven

分别打开它们的链接都有各自的安装教程

2 把项目拉到本地

使用这个把项目拉到本地。

git clone https://github.com/Akarin-project/Akarin

3 把子模块拉到本地

使用这个把子模块拉到本地

git submodule update --remote

4 开始构建AKarin

运行项目根目录下的akarin文件并添加jar参数

./akarin jar

相关问题解决方法

在构建是你可能会遇见这些：

• 无发克隆到子模块
• 出现java ZIP相关报错
• 构建时下载不到文件

1 无法克隆到子模块

这个问题原因位GitHub访问不稳定导致的

在这里有两个解决方法：

1 翻墙/科学上网

2 使用镜像站点https://github.91chi.fun/

​ 使用方法

先打开个目录下的.gitmodules文件把原来的内容替换成这个

[submodule "Tuinity"]
	path = Tuinity
	url = https://github.91chi.fun/https://github.com/Spottedleaf/Tuinity
	branch = ver/1.15.2

保存后执行这个加载更改的内容

git submodule sync

之后就可以去克隆子模块了

2 出现java ZIP相关报错

这个就和简单了，就是你在构建时没有或使用过其它版本的 Java ，使用java -version查看系统默认的Java版本，Java8 会有类似以下结果

$ java -version
openjdk version "1.8.0_312"
OpenJDK Runtime Environment (build 1.8.0_312-8u312-b07-0ubuntu1~20.04-b07)
OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)

3 构建时下载不到文件(./akarin jar)

这个分两种情况

1 在克隆子模块的子模块相关文件时出错

​ 这个可以借鉴 无法下载到子模块 的解决方法

2 无发下载某些jar,xmml等文件

​ 这个这个就是个人网络的问题了，只能翻墙或着多跑几遍

​

[josephworks]

Thank you for writing this. I can port this to the wiki soon.

[josephworks]

I will leave this open for the time being for visibility.

[ghost]

补充：构建时下载不到文件提示Blocked mirror for repositories时请将maven版本降至<=3.6.3（适用于1.12.2）