固定移动壳本地构建产物路径

移动壳 EAS 本地构建脚本输出到根 build/native/mobile

移动壳配置检查校验 APK 与 iOS simulator 压缩包路径

同步原生壳方案文档和共享决策记录

apps/mobile-shell/package.json

@@ -9,8 +9,8 @@
     "android": "expo run:android",
     "ios": "expo run:ios",
     "test": "vitest run -c vitest.config.ts",
-    "build:android": "eas build --local --profile production --platform android",
-    "build:ios": "eas build --local --profile production-simulator --platform ios",
+    "build:android": "eas build --local --profile production --platform android --output ../../build/native/mobile/genarrative-mobile-android.apk",
+    "build:ios": "eas build --local --profile production-simulator --platform ios --output ../../build/native/mobile/genarrative-mobile-ios-simulator.tar.gz",
     "build-config:smoke": "node scripts/check-eas-build-config.mjs",
     "config:smoke": "node scripts/check-expo-config.mjs",
     "export:smoke": "node scripts/check-expo-export.mjs",

apps/mobile-shell/scripts/check-config.mjs

@@ -206,6 +206,10 @@ const rootPackageLock = JSON.parse(fs.readFileSync(rootPackageLockPath, 'utf8'))
 const iconPath = new URL('../assets/icon.png', import.meta.url);
 const icon = PNG.sync.read(fs.readFileSync(iconPath));
 const brandBackgroundColor = '#fffdf9';
+const androidBuildOutputPath =
+  '../../build/native/mobile/genarrative-mobile-android.apk';
+const iosSimulatorBuildOutputPath =
+  '../../build/native/mobile/genarrative-mobile-ios-simulator.tar.gz';
 const productionSourceRoots = [
   new URL('../App.tsx', import.meta.url),
   new URL('../app.json', import.meta.url),
@@ -706,8 +710,8 @@ for (const [scriptName, expected] of Object.entries({
   android: 'expo run:android',
   ios: 'expo run:ios',
   test: 'vitest run -c vitest.config.ts',
-  'build:android': 'eas build --local --profile production --platform android',
-  'build:ios': 'eas build --local --profile production-simulator --platform ios',
+  'build:android': `eas build --local --profile production --platform android --output ${androidBuildOutputPath}`,
+  'build:ios': `eas build --local --profile production-simulator --platform ios --output ${iosSimulatorBuildOutputPath}`,
   'build-config:smoke': 'node scripts/check-eas-build-config.mjs',
   'config:smoke': 'node scripts/check-expo-config.mjs',
   'export:smoke': 'node scripts/check-expo-export.mjs',
@@ -1217,6 +1221,18 @@ if (easConfig.cli?.version !== '>= 20.3.0' || easConfig.cli?.appVersionSource !=
   throw new Error('mobile shell EAS builds must pin CLI floor and use local app version fields');
 }
 
+for (const [label, outputPath, extension] of [
+  ['Android', androidBuildOutputPath, '.apk'],
+  ['iOS simulator', iosSimulatorBuildOutputPath, '.tar.gz'],
+]) {
+  if (!outputPath.startsWith('../../build/native/mobile/')) {
+    throw new Error(`mobile shell ${label} local build output must stay under root build/native/mobile`);
+  }
+  if (!outputPath.endsWith(extension)) {
+    throw new Error(`mobile shell ${label} local build output must end with ${extension}`);
+  }
+}
+
 if (
   easConfig.build?.production?.distribution !== 'internal' ||
   easConfig.build?.production?.channel !== 'production' ||

apps/mobile-shell/scripts/check-eas-build-config.mjs

@@ -8,6 +8,10 @@ const packagePath = new URL('package.json', shellRoot);
 const easConfig = JSON.parse(fs.readFileSync(easConfigPath, 'utf8'));
 const packageConfig = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
 const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+const androidBuildOutputPath =
+  '../../build/native/mobile/genarrative-mobile-android.apk';
+const iosSimulatorBuildOutputPath =
+  '../../build/native/mobile/genarrative-mobile-ios-simulator.tar.gz';
 
 function assertObject(value, label) {
   if (!value || typeof value !== 'object' || Array.isArray(value)) {
@@ -69,18 +73,30 @@ for (const scriptName of ['build:android', 'build:ios', 'build-config:smoke']) {
 
 if (
   packageConfig.scripts['build:android'] !==
-  'eas build --local --profile production --platform android'
+  `eas build --local --profile production --platform android --output ${androidBuildOutputPath}`
 ) {
   throw new Error('mobile shell Android package build script drifted');
 }
 
 if (
   packageConfig.scripts['build:ios'] !==
-  'eas build --local --profile production-simulator --platform ios'
+  `eas build --local --profile production-simulator --platform ios --output ${iosSimulatorBuildOutputPath}`
 ) {
   throw new Error('mobile shell iOS package build script drifted');
 }
 
+for (const [label, outputPath, extension] of [
+  ['Android', androidBuildOutputPath, '.apk'],
+  ['iOS simulator', iosSimulatorBuildOutputPath, '.tar.gz'],
+]) {
+  if (!outputPath.startsWith('../../build/native/mobile/')) {
+    throw new Error(`mobile shell ${label} local build output must stay under root build/native/mobile`);
+  }
+  if (!outputPath.endsWith(extension)) {
+    throw new Error(`mobile shell ${label} local build output must end with ${extension}`);
+  }
+}
+
 if (packageConfig.scripts['build-config:smoke'] !== 'node scripts/check-eas-build-config.mjs') {
   throw new Error('mobile shell EAS config smoke script drifted');
 }

docs/project-memory/shared-memory/decision-log.md

@@ -2974,7 +2974,7 @@
 ## 2026-06-20 移动壳 EAS 原生包构建 profile
 
 - 背景：移动壳已能通过 Expo managed config 和 Metro production bundle smoke，但缺少原生安装包构建 profile；如果只保留 `expo export`，无法证明 Android / iOS 壳有进入原生分发链路的配置。
-- 决策：新增 `apps/mobile-shell/eas.json` 和 `eas-cli` devDependency。Android `production` profile 使用本地 EAS build 产出内部 APK；iOS `production-simulator` profile 产出 simulator release 包，避免在没有真实签名凭据时写入伪证书配置。两端 profile 都用本地 `app.json` 版本字段并设置 `EXPO_NO_DOTENV=1`，当前不配置商店提交、签名凭据来源、自动递增、OTA runtimeVersion 或 releaseChannel；`check-eas-build-config.mjs` 必须从 `apps/mobile-shell` 目录执行本地 EAS CLI 版本检查，确认解析到受检版本。`apps/mobile-shell/scripts/check-config.mjs` 必须反查根级门禁仍保留 EAS build profile、Expo config 和 Metro export 三个移动分发烟测。
+- 决策：新增 `apps/mobile-shell/eas.json` 和 `eas-cli` devDependency。Android `production` profile 使用本地 EAS build 产出内部 APK；iOS `production-simulator` profile 产出 simulator release 包，避免在没有真实签名凭据时写入伪证书配置。两端 profile 都用本地 `app.json` 版本字段并设置 `EXPO_NO_DOTENV=1`，真实本地构建输出固定到根目录 `build/native/mobile/` 下的 Android APK 和 iOS simulator 压缩包。当前不配置商店提交、签名凭据来源、自动递增、OTA runtimeVersion 或 releaseChannel；`check-eas-build-config.mjs` 必须从 `apps/mobile-shell` 目录执行本地 EAS CLI 版本检查，确认解析到受检版本，并校验固定输出路径和扩展名。`apps/mobile-shell/scripts/check-config.mjs` 必须反查根级门禁仍保留 EAS build profile、Expo config 和 Metro export 三个移动分发烟测。
 - 影响范围：`apps/mobile-shell/eas.json`、`apps/mobile-shell/package.json`、`apps/mobile-shell/scripts/check-eas-build-config.mjs`、`apps/mobile-shell/scripts/check-config.mjs`、`scripts/check-native-shells.mjs`、原生壳方案和验收文档。
 - 验证方式：`npm run mobile-shell:build-config`、`npm run mobile-shell:typecheck`、`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。
 

docs/【前端架构】ExpoReactNative与Tauri宿主壳方案-2026-06-17.md

@@ -515,7 +515,7 @@ GameBridge 禁止：
 
 2026-06-18 追加：移动壳 Metro export 烟测进入统一验收。`npm run check:native-shells` 会执行 `npm run mobile-shell:export`，用 Expo CLI 分别为 Android 和 iOS 生成 production bundle，校验 Metro metadata 版本、单平台 `fileMetadata`、Hermes `AppEntry-*.hbc` bundle 路径、assets 数组、生产 H5 URL 和原生宿主上下文 token 后清理临时 `.expo-export-smoke/` 目录。该烟测不生成 APK、AAB 或 IPA，也不写商店资料，只证明移动壳入口、Expo/RN 依赖和平台差异代码能被真实生产 bundler 打包。
 
-2026-06-20 追加：移动壳新增 EAS 原生包构建 profile。`apps/mobile-shell/eas.json` 固定 EAS CLI 下限、使用本地 `app.json` 版本字段，并提供 Android `production` 本地构建脚本产出可安装 APK、iOS `production-simulator` 本地构建脚本产出 release simulator 包；两者都设置 `EXPO_NO_DOTENV=1`，避免本机 `.env` 把开发 H5 URL 或私密配置带进可分发包。当前仍不写商店提交 profile、签名凭据来源、自动递增、OTA runtimeVersion 或 releaseChannel；`npm run check:native-shells` 只跑 `mobile-shell:build-config` 校验构建 profile、脚本、本地 `eas-cli` devDependency 和从 `apps/mobile-shell` 目录解析到的 EAS CLI 版本，真实 `mobile-shell:build:android` / `mobile-shell:build:ios` 作为具备 Android SDK、Xcode / simulator 环境和 EAS 本地构建依赖时的分发构建命令。
+2026-06-20 追加：移动壳新增 EAS 原生包构建 profile。`apps/mobile-shell/eas.json` 固定 EAS CLI 下限、使用本地 `app.json` 版本字段，并提供 Android `production` 本地构建脚本产出可安装 APK、iOS `production-simulator` 本地构建脚本产出 release simulator 包；两者都设置 `EXPO_NO_DOTENV=1`，避免本机 `.env` 把开发 H5 URL 或私密配置带进可分发包。真实 `mobile-shell:build:android` 输出到根目录 `build/native/mobile/genarrative-mobile-android.apk`，真实 `mobile-shell:build:ios` 输出到 `build/native/mobile/genarrative-mobile-ios-simulator.tar.gz`，该目录沿用根 `build/` 的 gitignore，只作为本机或 CI 可收集产物目录。当前仍不写商店提交 profile、签名凭据来源、自动递增、OTA runtimeVersion 或 releaseChannel；`npm run check:native-shells` 只跑 `mobile-shell:build-config` 校验构建 profile、脚本、本地 `eas-cli` devDependency、固定输出路径和从 `apps/mobile-shell` 目录解析到的 EAS CLI 版本，真实 `mobile-shell:build:android` / `mobile-shell:build:ios` 作为具备 Android SDK、Xcode / simulator 环境和 EAS 本地构建依赖时的分发构建命令。
 
 2026-06-18 追加：登录 / 支付能力伪声明进入门禁。`auth.requestLogin` 和 `payment.request` 保留在共享 HostBridge 契约中供未来真实接入，但 Expo 与 Tauri 壳在没有真实 SDK、渠道流程和后端契约前不得声明这些 capability，也不得把它们写入 `hostCapabilities`；请求到达壳层时必须返回明确 `unsupported_method`，让 H5 fallback 承接。两端壳测试会直接覆盖这两个 method，避免后续半接入时返回伪成功。