源码编译开源项目 Memos 安卓版 APK

windows11下编译开源项目 https://github.com/mudkipme/MoeMemosAndroid 的 0.8.5（对应 Memos-v0.24.0）版本 APK 步骤。

1. 检出源码

# 1）clone 项目
git clone https://github.com/mudkipme/MoeMemosAndroid.git
cd MoeMemosAndroid
# 2）拉取远端标签（若还没拉过）
git fetch origin --tags
# 3）查看是否有 0.8.5 的 tag
git tag -l "*0.8.5*"
# 4）切换到 0.8.5 对应版本（对应 memos-v0.24.0）
git checkout 0.8.5

2. 安装 Android 开发环境

要编译 APK 你需要准备：

✔ Java JDK（建议 17）
✔ Android Studio 最新版
✔ Android SDK + Android Build Tools

安装 Java JDK 17

构建 MoeMemosAndroid：JDK 17 完全正确、官方推荐

不建议用 JDK 21 / 22（很多 Android 项目不兼容）

Android Gradle Plugin 对 JDK 要求非常严格

JDK 17 = 最稳妥选择

1). 到 Oracle / OpenJDK 网站下载： https://jdk.java.net/17/

方案一（最简单、最稳）：Eclipse Temurin（强烈推荐）
这是 Android 官方 & 大多数开发者最常用的 OpenJDK 发行版。

下载地址（Windows x64）：
https://adoptium.net/temurin/releases/?version=17

2). 安装完成后，设定环境变数：

JAVA_HOME = C:\Program Files\Java\jdk-17
Path 加入 %JAVA_HOME%\bin

检查是否安装成功：

java -version

显示 17.x.x 即成功。

安装 Android Studio

1). 下载 Android Studio： https://developer.android.com/studio

2). 安装完成后开启一遍 → 会自动安装 Android SDK。

确保 Android SDK 环境完整

打开：

Android Studio -> SDK Manager

要安装：

✔ Android SDK Platform
✔ Android SDK Build-Tools
✔ Android SDK Command-line Tools
✔ Android 12/13/14 API（依专案需求）

3. 汇入专案到 Android Studio

1). Android Studio 打开

2). 选 Open

3). 选到 Repo 根目录

4). 等待 Gradle 下载依赖

4. 设定 Gradle Build

如果专案有版本设定不合 → 你可能要调整：

✔ gradle-wrapper.properties
✔ build.gradle

⚠ 确认：

compileSdkVersion
targetSdkVersion
buildToolsVersion

要对应你下载的 SDK。

5. 编译 APK

方法有两种：

方法 A：用 Android Studio 编译

菜单点：

Build → Build Bundle(s) / APK(s) → Build APK(s)

等待成功后：

app\build\outputs\apk\debug\app-debug.apk

方法 B：用 Terminal 编译

在专案根目录跑：

gradlew assembleDebug

或者 Release 版：

gradlew assembleRelease

成功后 APK 会在：

app\build\outputs\apk\[buildType]\

6. 签名 & 封包 Release APK（可选）

如果你要打 正式上架版 APK：

生成签名 Key：

keytool -genkey -v -keystore release.keystore -alias moeapp -keyalg RSA -keysize 2048 -validity 10000

在 gradle.properties 加：

KEYSTORE_FILE=release.keystore
KEYSTORE_PASSWORD=你的密码
KEY_ALIAS=moeapp
KEY_PASSWORD=你的密码

在 app/build.gradle 裡加 signingConfigs：

signingConfigs {
    release {
        storeFile file(KEYSTORE_FILE)
        storePassword KEYSTORE_PASSWORD
        keyAlias KEY_ALIAS
        keyPassword KEY_PASSWORD
    }
}
buildTypes {
    release {
        signingConfig signingConfigs.release
        minifyEnabled false
    }
}

再跑 release build：

gradlew assembleRelease

得到真正可上架的 app-release.apk

7. 安装到手机测试

把 APK 拷到手机：

adb install app-debug.apk

或

adb install app-release.apk

⚠ 常见错误 & 解法

问题	解决方法
Gradle 下载失败	代理 / 改 Gradle 镜像
Java 版本错误	改用 JDK17
SDK 版本不匹配	更新 Android SDK
未找到 keystore	重新生成 keystore