3.5 KiB
3.5 KiB
Android final package — 2026-10-13
Synced behavior
- macOS's targeted video policy now also applies to Android's platform-owned TUN: raw VLESS/Reality Vision, global or bypass-CN mode, detected QUIC on UDP/443 for googlevideo.com/subdomains only. Existing mesh, private and GeoIP routes take precedence. Other QUIC domains, non-QUIC UDP/443, other transports and custom rule mode remain unchanged. No new manual network settings.
- Android profiles now use the application-private files directory,
files/MeshPort/proxy-profile.jsonandfiles/MeshPort/network-profile.toml, with 0700/0600 permissions and atomic writes. Existing encrypted SharedPreferences are read with their original Android Keystore keys once for migration. No new key is generated when reading legacy data. Regular reads/writes use files; old encrypted data remains as a backup. Deletion records a migration tombstone to prevent resurrection. A failed migration remains pending without retrying at every launch; Settings provides explicit retry. - Shared settings show the native storage path and migration status. Auto-connect waits if migration is pending. Android VPN authorization continues to use VpnService.prepare, which already skips the consent dialog while permission remains granted. macOS administrator helpers and menu bar behavior do not apply to Android.
Validation
- Shared Go bridge suite, race tests and vet passed. Real sing-box rule matching and sniffer construction cover macOS and Android configurations in global/bypass-CN modes; Android policy requires a platform TUN.
- Android JVM storage tests: 4 passed, 0 failures/errors/skips. Covered migration, private permissions, restart, deletion, pending retry, corrupt files, oversized writes and symlink rejection. These use isolated host filesystem fixtures, not real phone data or real Android Keystore entries.
- Flutter suite passed (50 passed, 6 skipped); analyzer clean.
- Release APK signature v2 verified. Certificate SHA-256 matches the preceding debug APK: 3c116d75d22a71f1a32a443d524c6293965b29c1647a7ac1cd41fcf13a312ec8. Release currently uses the existing Android debug signing identity for compatible local upgrades, not a store distribution key.
- ZIP alignment for 16 KB pages and every packaged native ELF load-segment alignment verified. APK is AOT Release, contains both native cores and only arm64-v8a libraries.
- Bundled default configuration byte-matches the public template; no private template or debug kernel blob bundled. Archive integrity passed. Packaging restores the original source configuration afterward.
- Direct Gradle Release unit-test invocation initially failed because Flutter tests regenerated a registrant containing the dev-only integration_test plugin. Debug JVM unit tests passed, followed by a fresh normal Flutter Release build which regenerated the production registrant. The shipped APK comes from that final build.
No ADB device was connected. No phone installation, real VPN permission dialogue, actual migration with phone Keystore data, or Android YouTube speed measurement was performed. Previous macOS throughput results do not establish Android performance.
Artifact
outputs/android/MeshPort-0.1.0-1791874725-release.apk
Version code: 1791874725; minimum Android API 26 (Android 8.0); ARM64; 56,536,849 bytes.
SHA-256: 25ad7a828305766c190ee6d6eefbcc8b42b3bc321c8af8efe42755f6853ab8db.
Rebuild with sh scripts/package-lab-android.sh. Install over the prior MeshPort APK to retain legacy configuration for migration; do not uninstall first. No commits or pushes were performed.