Merge pull request #1500 from wgqqqqq/feat/native-mobile-apps

feat: add native Android, iOS, and HarmonyOS app scaffolds

Author: GCWing

src/apps/mobile/AGENTS.md

@@ -0,0 +1,26 @@
+# AGENTS.md
+
+Native mobile applications are product entrypoints under `src/apps/mobile`.
+
+## Boundaries
+
+- Keep Android, iOS, and HarmonyOS lifecycle and platform API usage inside the
+  corresponding platform directory.
+- Keep reusable product logic platform-agnostic and expose it through stable
+  contracts or adapters.
+- Do not import implementation details from `src/apps/desktop` or
+  `src/web-ui`.
+- Treat remote workspace support as part of feature design. Gate unsupported
+  behavior with a clear user-facing state.
+- Keep credentials, signing files, provisioning profiles, device identifiers,
+  and local SDK paths out of the repository.
+- Add platform-specific build and verification commands here when a native
+  toolchain is selected.
+
+## Directory Ownership
+
+| Directory | Ownership |
+|---|---|
+| `android/` | Android app, resources, lifecycle, and adapters |
+| `ios/` | iOS app, resources, lifecycle, and adapters |
+| `harmonyos/` | HarmonyOS app, resources, lifecycle, and adapters |

src/apps/mobile/README.md

@@ -0,0 +1,15 @@
+# BitFun Native Mobile Apps
+
+This directory contains the native mobile product surfaces for BitFun:
+
+- `android/`: Android application code and resources.
+- `ios/`: iOS application code and resources.
+- `harmonyos/`: HarmonyOS application code and resources.
+
+Each platform directory owns its native UI, lifecycle, permissions, packaging,
+and platform adapters. Product logic and stable contracts should remain in the
+platform-agnostic Rust layers and be exposed to these apps through explicit
+interfaces.
+
+The directories are intentionally build-tool agnostic until the native stacks
+and minimum supported platform versions are selected.

src/apps/mobile/android/README.md

@@ -0,0 +1,11 @@
+# BitFun Android
+
+Android application entrypoint.
+
+Provisional source layout:
+
+- `app/src/main/kotlin/`: Kotlin application code.
+- `app/src/main/res/`: Android resources.
+
+Add the Gradle project files after the Android UI stack, package identifier,
+minimum SDK, and shared-core integration strategy are selected.

src/apps/mobile/android/app/src/main/kotlin/.gitkeep

@@ -0,0 +1 @@
+

src/apps/mobile/android/app/src/main/res/.gitkeep

@@ -0,0 +1 @@
+

src/apps/mobile/harmonyos/.gitignore

@@ -0,0 +1,30 @@
+/node_modules
+/oh_modules
+/local.properties
+/.idea
+.DS_Store
+**/build
+/.hvigor
+**/.hvigor
+.cxx
+/.clangd
+/.clang-format
+/.clang-tidy
+**/.test
+/.appanalyzer
+
+# Local emulator verification artifacts
+/bitfun_*.jpeg
+/bitfun_*_layout.json
+/bitfun_layout*.json
+.bitfun/
+/.bitfun/search/flashgrep-index/
+
+# Signing credentials and installable artifacts
+*.cer
+*.key
+*.p12
+*.p7b
+*.pem
+*.hap
+*.app

src/apps/mobile/harmonyos/AppScope/app.json5

@@ -0,0 +1,11 @@
+{
+  "app": {
+    "bundleName": "com.example.bitfun_mobile",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "buildVersion": "1",
+    "icon": "$media:bitfun_icon",
+    "label": "$string:app_name"
+  }
+}

src/apps/mobile/harmonyos/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "BitFun"
+    }
+  ]
+}