From bb3699267f87d23592fe2ef898809d9fcf88be91 Mon Sep 17 00:00:00 2001
From: AskaEth <i@yeij.top>
Date: Sun, 16 Aug 2026 15:19:07 +0800
Subject: [PATCH] docs: adapt plan for arm64 build environment

---
 .gitignore                                    |  3 ++
 .../plans/2026-08-16-hearth-launcher.md       | 32 ++++++++++++++++---
 2 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index 5b90000..f8bf0b3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,5 @@
 # Superpowers brainstorm mockups / session state
 .superpowers/
+
+# Android 本地 SDK 路径
+local.properties
diff --git a/docs/superpowers/plans/2026-08-16-hearth-launcher.md b/docs/superpowers/plans/2026-08-16-hearth-launcher.md
index 091f6f3..73886d7 100644
--- a/docs/superpowers/plans/2026-08-16-hearth-launcher.md
+++ b/docs/superpowers/plans/2026-08-16-hearth-launcher.md
@@ -11,6 +11,9 @@
 ## Global Constraints
 
 - 包名 `top.yeij.hearth`；`minSdk = 30`，`targetSdk = 30`
+- 构建版本（arm64 环境适配）：AGP `8.6.1`、Gradle `8.9`、`compileSdk = 35`、`build-tools 34.0.0`
+- 依赖仓库走阿里云镜像：`maven.aliyun.com/repository/google` + `/central`（dl.google.com 不通）
+- aapt2 用 arm64 版：`gradle.properties` 设 `android.aapt2FromMavenOverride=/home/Aska/Android/Sdk/build-tools/34.0.0/aapt2`
 - 横屏锁定 `screenOrientation = landscape`
 - 依赖仅限：OkHttp、Gson（原生）；H5 零依赖
 - Miuix 视觉：深色背景 `#000`、卡片 `#151518`、强调色 `#ff6900`；侧边栏收起 80px / 展开 240px
@@ -86,11 +89,20 @@ Hearth/                                   # 仓库根（已存在，含 README/L
 `settings.gradle.kts`：
 ```kotlin
 pluginManagement {
-    repositories { google(); mavenCentral(); gradlePluginPortal() }
+    repositories {
+        maven("https://maven.aliyun.com/repository/google")
+        maven("https://maven.aliyun.com/repository/central")
+        maven("https://maven.aliyun.com/repository/gradle-plugin")
+        google(); mavenCentral(); gradlePluginPortal()
+    }
 }
 dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
-    repositories { google(); mavenCentral() }
+    repositories {
+        maven("https://maven.aliyun.com/repository/google")
+        maven("https://maven.aliyun.com/repository/central")
+        google(); mavenCentral()
+    }
 }
 rootProject.name = "Hearth"
 include(":app")
@@ -99,7 +111,7 @@ include(":app")
 `build.gradle.kts`（根）：
 ```kotlin
 plugins {
-    id("com.android.application") version "8.5.2" apply false
+    id("com.android.application") version "8.6.1" apply false
     id("org.jetbrains.kotlin.android") version "1.9.24" apply false
 }
 ```
@@ -112,7 +124,7 @@ plugins {
 }
 android {
     namespace = "top.yeij.hearth"
-    compileSdk = 34
+    compileSdk = 35
     defaultConfig {
         applicationId = "top.yeij.hearth"
         minSdk = 30
@@ -132,6 +144,18 @@ dependencies {
 }
 ```
 
+`gradle.properties`（根，aapt2 arm64 覆盖 + JVM 内存）：
+```properties
+org.gradle.jvmargs=-Xmx2048m
+android.useAndroidX=true
+android.aapt2FromMavenOverride=/home/Aska/Android/Sdk/build-tools/34.0.0/aapt2
+```
+
+`local.properties`（sdk 路径，**不入库**，加入 `.gitignore`）：
+```properties
+sdk.dir=/home/Aska/Android/Sdk
+```
+
 `AndroidManifest.xml`：
 ```xml
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">