使用 fitsSystemWindows

這是最快的方法。在 XML 佈局中，對最外層的 FrameLayout 加入屬性：

XML

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">
    </FrameLayout>

這會讓系統自動幫 FrameLayout 加上內邊距，避開狀態列與導覽列。

程式碼精確控制

如果你只需要頂部避開狀態列，或是想保留背景填滿全螢幕，建議在 Activity 中使用 ViewCompat 監聽器。

Kotlin

ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.your_frame_layout)) { view, insets ->
    val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
    // 根據需求設定 padding
    view.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
    insets
}

這段程式碼會抓取系統欄的高度。將它設為 FrameLayout 的 padding 後，內容就不會被遮擋。

暫時停用強制規範

如果你還沒準備好適應新規則，可以在 Android 15 (API 35) 的主題中加入這個屬性。但注意這只是過渡方案，未來版本可能失效。²

在 res/values-v35/themes.xml 加入：

XML

<item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>

這會讓 App 回到舊版的顯示邏輯，不再自動延伸到系統欄下方。

Handling Edge-to-Edge in Android 15

這段影片詳細解說了 Android 15 強制全螢幕的原理，並示範如何在 Compose 和傳統 XML 中正確處理系統內邊距。

您遇到的錯誤訊息：

“Starting in Kotlin 2.0, the Compose Compiler Gradle plugin is required when compose is enabled.”

這表示編譯器誤以為您的專案正在使用 Jetpack Compose (Android 的現代 UI 工具包)，但缺少了 Compose Compiler 插件。

google 官方文件:
https://developer.android.com/develop/ui/compose/compiler?hl=zh-tw

有看沒有懂…

解決方案：檢查並新增 Kotlin 支援

解決這個問題的關鍵是確保您的專案正確地配置了 Kotlin Android Plugin 和 Kotlin Standard Library。

步驟 1: 檢查 Project-level 的 build.gradle (或 settings.gradle.kts)

確保您的專案級別 (Project-level) 的設定檔案中，已經加入了 Kotlin Gradle Plugin 的 Classpath。

在 build.gradle (Project 級別):

buildscript {
    ext.kotlin_version = '1.9.22' // 根據您的專案需求使用最新或穩定版本
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // ... 其他 dependencies
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" // <--- 確保有這行
    }
}

• 注意： 如果您使用的是新的 Gradle 設定方式 (Kotlin DSL)，則應在 settings.gradle.kts 中確保有這個 Plugin。

步驟 2: 編輯 Module-level 的 build.gradle (通常是 app/build.gradle)

這是最重要的步驟，您必須在編寫 Kotlin 程式碼的模組 (Module) 中應用 (apply) Kotlin 插件並新增必要的相依性。

在 app/build.gradle (Module 級別):

1. 套用 Plugin (Apply Plugin): 在檔案頂部，新增 kotlin-android 插件。 // 確保這裡有這兩行 plugins { id 'com.android.application' id 'org.jetbrains.kotlin.android' // <--- 確保有這行 // 如果您的專案是純 Java 且您剛剛加入 kotlin 檔案，您可能會需要將： // apply plugin: 'com.android.application' // 改為新的 `plugins` 區塊並加入 'org.jetbrains.kotlin.android' }
2. 新增 Kotlin 標準庫 (Standard Library): 在 dependencies 區塊中，新增 Kotlin 標準庫。 dependencies { // ... 其他 dependencies// 新增 Kotlin 標準庫相依性 implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version" // <--- 確保有這行 // 如果您使用 Kotlin 與 Activity 或 Fragment 交互，建議也加入 KTX implementation "androidx.core:core-ktx:1.12.0" // 確保您使用的版本是最新的}

步驟 3: 移除或禁用 Compose 相關設定 (如果沒有使用 Compose)

如果您的專案確定沒有使用 Jetpack Compose，但錯誤訊息仍然出現，這可能是因為您在 app/build.gradle 中意外啟用了 Compose 設定。

請檢查 android 區塊：

• 尋找以下設定，如果存在且您沒有使用 Compose，請將其移除或註解掉：
  gradle android { // ... buildFeatures { // 這個可能會導致錯誤，如果專案沒有使用 Compose UI compose true // <--- 移除或改成 false } // ... }

最終動作

完成上述步驟後，請在 Android Studio 中點擊 Sync Now (或 Gradle 檔案修改後自動出現的同步提示)，讓 Gradle 下載並應用新的設定。這樣應該就能解決編譯器報錯，並允許 Java 程式碼正確地與您的 .kt 檔案（例如 BaseActivity.kt）互動。

核心原因分析

1. useLegacyPackaging = false 的作用：這個設定告訴 Android 建置系統（AGP），不要把 APK 裡面的 .so 檔案解壓縮到手機的 /data/app/…/lib/ 目錄下。它會讓系統直接從 APK 包裡面讀取這些函式庫（為了節省手機空間）。這就是為什麼你用 adb ls 看到目錄是空的。
2. OpenVPN (ics-openvpn) 的運作方式：Cake-VPN（以及大多數基於 ics-openvpn 的專案）並不是像一般 App 那樣只用 System.loadLibrary。它實際上是把 libovpnexec.so 當作一個可執行檔 (Executable) 來跑。Java 程式碼會嘗試去執行類似這樣的指令：/data/app/…/lib/arm64/libovpnexec.so …。因為你設了 false，檔案不存在於那個路徑上，導致 java.io.IOException，程式崩潰。

解決方案

為了同時修復崩潰問題並通過 Google Play 的 16 KB Page Size 檢查，你需要採取兩步走的策略：

第一步：修復崩潰（改回 True）

你必須允許 Native Library 被解壓縮，因為這個 App 的架構依賴於實體檔案的存在。

修改 build.gradle：

Groovy

android {
    packaging {
        jniLibs {
            // 改回 true (或者直接刪除這段，因為預設通常是 true)
            // 這樣 Android 才會把 .so 檔解壓到 /data/app/.../lib 目錄
            useLegacyPackaging = true
        }
    }
    // ... 其他設定
}

做完這步，你的 App 就能正常啟動了，但可能還過不了 16 KB 檢查。接下來看第二步。

第二步：真正解決 16 KB 對齊問題 (Rebuild NDK)

既然我們必須解壓縮 .so 檔（useLegacyPackaging = true），那麼 Google Play 的要求就是：這些解壓縮出來的 ELF (.so) 檔案，其 Segment 必須是 16 KB 對齊的。

這代表你不能只改 build.gradle 的 packaging 設定，你需要重新編譯 C/C++ 原始碼，並加上 Linker flags。

請在你的 build.gradle (Module level) 加入以下設定，強制 NDK 使用 16KB 對齊：

android {
    defaultConfig {
        // ... 其他設定
        
        externalNativeBuild {
            cmake {
                // 這是關鍵：告訴 Linker 使用 16KB (16384 bytes) 的 Page Size
                cppFlags "-Wl,-z,max-page-size=16384"
                arguments "-DANDROID_STL=c++_shared"
            }
            // 如果你是用 ndk-build (Android.mk)，則需要用不同的參數，但大多數現在都用 cmake
        }

        ndk {
            abiFilters "arm64-v8a", "x86_64"
        }
    }
}

注意：

如果你的專案不是透過 CMake 編譯（例如直接引用 libs/ 資料夾下的預編譯 .so 檔），那麼你無法透過 Gradle 修改對齊。你必須找到這些 .so 檔的原始碼重新編譯，或者尋找已經支援 16KB Alignment 的第三方庫版本。

驗證方法

修改並重新 Build 出 APK 後，請使用 Android SDK 提供的工具 zipinfo 或 Linux 的 readelf 來檢查。

1. 解壓 APK，取出裡面的 .so 檔。
2. 在終端機執行：
   readelf -l libovpnexec.so | grep LOAD
3. 檢查輸出中的 Align 欄位。如果是 0x4000 (16384)，代表成功；如果是 0x1000 (4096)，代表失敗。

總結

1. 把 useLegacyPackaging 改回 true (讓 OpenVPN 找得到檔案)。
2. 在 externalNativeBuild 加入 -Wl,-z,max-page-size=16384 (讓編譯出來的檔案符合 Google 規範)。

AIDL 檔雖然存在，但 Android 根本沒有編譯它

也就是說：

Gradle 沒把你的 vpnLib 的 AIDL 納入編譯流程 → 所以 IOpenVPNServiceInternal 永遠不會產生 → Java 當然 import 不到

你目前的 AIDL 檔案是正確的

你的檔案內容：

package de.blinkt.openvpn.core;

你的路徑：

vpnLib/src/main/aidl/de/blinkt/openvpn/core/IOpenVPNServiceInternal.aidl

這是正確擺放位置，Android 應該會編譯它。

但它沒被編譯，原因不是 package 錯誤，而是：

真正原因：vpnLib 模組沒有被設定為支援 AIDL

在 Android Gradle Plugin 8+（對應 Android Studio 最新版本），你必須明確啟用 AIDL sourceSets，否則 AIDL 不會自動被編譯。

Cake-VPN 的 vpnLib 是 module library（com.android.library），預設 aidl 不會啟用。

解決方法：在 vpnLib/build.gradle 增加 AIDL 設定

請在：

vpnLib/build.gradle

加入以下設定：

android {
    // 這行是關鍵
    buildFeatures {
        aidl true
    }

    sourceSets {
        main {
            aidl.srcDirs = ['src/main/aidl']
        }
    }
}

加入後重新 build，你將會看到：

Android 會產生：

vpnLib/build/generated/aidl_source_output_dir/debug/out/de/blinkt/openvpn/core/IOpenVPNServiceInternal.java

然後 Java 中就可以正常 import：

import de.blinkt.openvpn.core.IOpenVPNServiceInternal;

額外注意：你的 AIDL 不完整（少兩個檔案）

ICS-OpenVPN 的同路徑下還有：

IOpenVPNStatusCallback.aidl
OpenVPNStatus.aidl

Cake-VPN 只放了：

IOpenVPNServiceInternal.aidl

這是不夠的。

你必須補齊：

1⃣ IOpenVPNStatusCallback.aidl

2⃣ OpenVPNStatus.aidl

否則 IOpenVPNServiceInternal 內的 type reference 會找不到。

你的錯誤訊息（重點）

Incorrect package="de.blinkt.openvpn" found in source AndroidManifest.xml
Setting the namespace via the package attribute in the source AndroidManifest.xml is no longer supported.
Recommendation: remove package="de.blinkt.openvpn" from the source AndroidManifest.xml

這代表你目前使用的 Android Gradle Plugin（AGP 8.0+）已完全 不允許在每個 module 的 AndroidManifest.xml 指定 package=。

為什麼會這樣？

AGP 8 之後，Google 改成新的規則：

AndroidManifest.xml 不能再寫 package="" 來定義 namespace。
必須在 build.gradle 中定義 namespace。

也就是：

以前（舊版 SDK）

Manifest 控制 package：

<manifest package="de.blinkt.openvpn">

現在（SDK 34 / AGP 8）

Manifest 不再允許 package
你需要改為：

android {
    namespace "de.blinkt.openvpn"
}

並且 移除 Manifest 的 package 屬性。

正確解決方式（適用 Cake-VPN、vpnLib module）

步驟 1：修改 vpnLib 的 build.gradle

找到：

vpnLib/build.gradle

加入：

android {
    namespace "de.blinkt.openvpn"
}

步驟 2：刪除 AndroidManifest.xml 的 package

你的原本內容：

<manifest package="de.blinkt.openvpn" />

請改為：

<manifest />

或乾脆改成：

<manifest />

也沒差（因為 library module 的 manifest 通常是空的）。

完整對照（修改前 / 修改後）

修改前（會報錯）

vpnLib/src/main/AndroidManifest.xml

<manifest package="de.blinkt.openvpn">
</manifest>

vpnLib/build.gradle

android {
    // 沒有 namespace → 錯誤
}

修改後（正確，可編譯）

vpnLib/src/main/AndroidManifest.xml

<manifest/>

vpnLib/build.gradle

android {
    namespace "de.blinkt.openvpn"
}

注意：library module 的 namespace 必須與其 Java package 一致

因為 vpnLib 裡所有 Java 檔都是：

package de.blinkt.openvpn;

所以 library module namespace 必須是：

de.blinkt.openvpn

否則：

• R 無法對應
• Build 會噴錯
• 依賴會錯亂

最終效果

完成後：

• Gradle 不再抱怨
• manifest 乾淨、符合 AGP 8 標準
• R 的 namespace 正常生成
• vpnLib 中可以使用：

de.blinkt.openvpn.R.string.xxx

• app module 也會自動合併資源

User Review Required

IMPORTANT

Library Dependency: We will use the ics-openvpn library (via JitPack). This is a large library that includes native code. The build time will increase, and the APK size will grow significantly (approx +10-15MB).

WARNING

Manifest Merging: The ics-openvpn library has its own 

AndroidManifest.xml. We need to ensure our minSdk and other attributes are compatible. The current minSdk is 23, which is good.

Proposed Changes

Build Configuration

[MODIFY] build.gradle

• Add ics-openvpn dependency.
• Enable multiDex (likely needed due to library size).

[MODIFY] settings.gradle

• Add jitpack.io repository if not present (usually in project-level, but settings.gradle is common in newer Android).

Core Logic

[MODIFY] MainActivity.java

• Remove check_openvpn_installed logic.
• Remove launch_openvpn intent logic.
• Remove “Install OpenVPN” UI prompts.
• Implement startVpnInternal():
  • Parse the downloaded .ovpn file using ics-openvpn‘s VpnProfile parser.
  • Add the profile to ProfileManager.
  • Start the VPN service using VPNLaunchHelper or direct Service intent.
• Implement IOpenVPNStatusCallback to update UI (Connected/Connecting/Failed) directly from the internal service.

[MODIFY] AndroidManifest.xml

• Add VpnService declaration (if not automatically merged).
• Add BIND_VPN_SERVICE permission.

UI Changes

[MODIFY] activity_main.xml

• (Optional) Remove the “Install OpenVPN” button/banner since it’s no longer needed.

Verification Plan

Automated Tests

• None available for VPN connectivity in this environment.

Manual Verification

• Build Check: Ensure Gradle syncs and builds (I will rely on code correctness as I cannot run Gradle).
• Code Review: Verify that MainActivity correctly imports the new classes and calls the internal service instead of startActivity.

上面是第一次的 plan, 但其實會出錯, 因為,

 @build.gradle  > Could not resolve all files for configuration ':app:debugCompileClasspath'.
   > Could not find com.github.schwabe:ics-openvpn:0.7.9.
     Required by:
         project :app

第2次 plan 如下:

Implementation Plan – Integrate Local OpenVPN Library

The goal is to remove the dependency on the external “OpenVPN for Android” app and the remote ics-openvpn artifact, instead using the local vpnLib module directly.

User Review Required

IMPORTANT

I will be modifying the build files to switch from a remote dependency to a local module. This assumes vpnLib is a complete and working copy of the OpenVPN library.

Proposed Changes

Build Configuration

[MODIFY] settings.gradle

• Ensure :vpnLib is included in the project.

[MODIFY] app/build.gradle

• Remove implementation 'com.github.schwabe:ics-openvpn:0.7.9' (or similar).
• Add implementation project(':vpnLib').

Code Integration

[MODIFY] MainActivity.java

• Ensure imports point to the local library packages (likely de.blinkt.openvpn...).
• Verify startVpnInternal and stopVpn use the local service correctly.

Verification Plan

Automated Tests

• Run ./gradlew assembleDebug to verify the build succeeds with the local dependency.

Manual Verification

• The user will need to run the app and verify that clicking “Connect” starts the VPN process without prompting to install an external app.

英文版的Email: Action Required: Your app is not compliant with Google Play Policies

解法：
https://stackoverflow.com/questions/70644513/how-to-fill-data-safety

Does your app collect or share any of the required user data types? Yes
Is all of the user data collected by your app encrypted in transit? Yes
Do you provide a way for users to request that their data is deleted? No

Location > Approximate location（概略位置）
App activity > Page views and taps in app
App info and performance > Crash logs, Diagnostics（當機記錄、診斷資料）
Device or other identifiers > Device or other identifiers（裝置 ID 或其他 ID）

Is this data collected, shared, or both? Both
收集：這項資料會從使用者的裝置傳出，由您 (開發人員) 或第三方接收，包括暫時處理的資料及儲存較長時間的資料。
分享：這項資料會轉移給使用者裝置或其他裝置上的第三方。

Is this data processed ephemerally? No
否，這項收集資料不是採暫時性方式處理

Is this data required for your app, or can users choose whether it’s collected? Data collection is required (users can’t turn off this data collection)
需要收集資料 (使用者無法關閉資料收集功能)

Why is this user data shared? Advertising or marketing
廣告或行銷
用於顯示或指定廣告/行銷通信內容，或衡量廣告成效。例如在應用程式中顯示廣告、傳送推播通知來宣傳其他產品或服務，或與廣告合作夥伴分享資料。

Prepare for Google Play’s data disclosure requirements
https://developers.google.com/admob/android/play-data-disclosure

Data collected and shared automatically

The Google Mobile Ads SDK collects and shares the following data types automatically for advertising, analytics, and fraud prevention purposes.

All of the user data collected by Google Mobile Ads SDK is encrypted in transit using the Transport Layer Security (TLS) protocol.

一個一個項目點, 超花時間, 請使用右上角提供的 export csv / import csv 功能:

Execution failed for task ':app:processDebugMainManifest'.
> Manifest merger failed with multiple errors, see logs

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

執行畫面：

可以點下面的4組的藍色的字（Run with –stacktrace、Run with –info、–debug、Run with –scan），或微微往上捲動一點，或左下角的分類點選較高層的（上層）。就可以看到詳細的錯誤訊息。

例如：

> Task :app:processDebugMainManifest FAILED
[com.google.android.ads.consent:consent-library:1.0.8] /Users/your-app/.gradle/caches/transforms-3/2d160dafc2c9bfb6dfe1eac4c35b8ef6/transformed/jetified-consent-library-1.0.8/AndroidManifest.xml Warning:
	Package name 'com.google.android.ads.consent' used in: com.google.android.ads.consent:consent-library:1.0.8, com.google.android.ump:user-messaging-platform:1.0.0.
/Users/your-app/app/src/main/AndroidManifest.xml:13:5-94:19 Error:
	tools:replace specified at line:13 for attribute android:appComponentFactory, but no new value specified
/Users/your-app/app/src/main/AndroidManifest.xml Error:
	Validation failed, exiting

真是太神奇，第13行的 tag 裡的 attrib: tools:replace 居然會造成出錯。

Execution failed for task ':app:lintVitalRelease'.
> A failure occurred while executing com.android.build.gradle.internal.lint.AndroidLintTask$AndroidLintLauncherWorkAction
   > There was a failure while executing work items
      > A failure occurred while executing com.android.build.gradle.internal.lint.AndroidLintWorkAction
         > Lint found fatal errors while assembling a release target.

執行畫面：

解法：

實際去 build 資料夾下，並沒有 report 的資料夾，但使用 Analyze > Inspect Code  的確可以看到很多神奇的錯誤與 Warring. 逐一的修改後，就不需使用 lintOptions 來解決。

1. You can use Analyze > Inspect Code menu to manually run inspections. The results appear in the Inspection Results window. This way you can view and fix the real issues.
2. You can still view them from app\build\reports\lint-results-release-fatal.html file without using aforementioned manual inspection menu.
3. Although it’s not recommended you can also suppress the lint warnings by adding below code into your build.gradle as Android Studio suggests. But keep in mind that this will not fix any real issues.

android {
    lintOptions {
        checkReleaseBuilds false
        // Or, if you prefer, you can continue to check for errors in release builds,
        // but continue the build even when errors are found:
        abortOnError false
    }
}

資料來源

錯誤的畫面：

解法：

Just delete this file:

C:\Users\YourUserName\.AndroidStudio4.X\config\disabled_plugins.txt

Update 10 Feb 2021:

If you couldn’t find this address try this on windows:

C:\Users\YourUserName\AppData\Roaming\Google\AndroidStudioPreview4.X\disabled_plugins.txt

Recently this Address transferred to here.

Update 04 August 2021:

If you are using windows 11 App data folder is hidden and needs to be prompted(just search how to take out missing app data folder in windows 11) Then go to the same location as earlier mentioned and delete that file

For Linux distros, the default configuration directory is ~/.config/Google/AndroidStudio4.x/

So deleting disabled_plugins.txt will enable all of your disabled plugins and solve your problem.

rm ~/.config/Google/AndroidStudio4.1/disabled_plugins.txt

For macOS, the default directory is ~/Library/Application Support/Google/AndroidStudio4.x

rm ~/Library/Application\ Support/Google/AndroidStudio4.1/disabled_plugins.txt

資料來源

Android Studio missing essential plugin org.jetbrains.android
https://stackoverflow.com/questions/61682609/android-studio-missing-essential-plugin-org-jetbrains-android