מובייל ופלטפורמות
מוכנות הפצה למובייל — P7
תיעוד הכנת גרסאות לחנויות ודרישות הקבלה החיצוניות.
בעמוד הזה
Locked scope#
P1–P6 approved screens, app appearance, assets, icons, map behavior, tenant isolation, authorization, financial workflows and provider integrations are immutable. P7 changes only native build configuration, explicit EAS environment identifiers, release preflight scripts/tests and this documentation. No image was replaced, regenerated or differently cropped.
Implementation shipped in this PR#
apps/mobile/app.config.tspreserves the approved identity and existingapp.jsonconfiguration. It addsreact-native-mapsAndroid native key configuration only whenGOOGLE_MAPS_ANDROID_API_KEYis provided as an environment variable at build time; no key is committed, and it has no effect on existing running builds.- Optionally attaches a registered
EAS_PROJECT_IDto the dynamic Expo configuration without changing project identity in source. - Existing
development,previewandproductionEAS build profiles now explicitly identify their respectiveEXPO_PUBLIC_APP_ENV. Other build options are unchanged. - Dependency-free
pnpm --filter @linknodes/mobile run release:preflightchecks the approved app IDs, Expo/EAS project, public runtime configuration, HTTPS endpoints, expected Production API origin, signed-Android Google Maps key presence, opaque 1024×1024 RGB store icon path, and opt-in telemetry prerequisites. It never prints secrets or signs/uploads a build. pnpm --filter @linknodes/mobile run test:releasechecks expected pass and fail-closed cases with synthetic fixtures.
Verified QA#
- P7 release preflight regression tests: 9/9 PASS.
- Running Production preflight without release credentials: exits 1 with missing-gate list (correct fail closed).
- Mobile TypeScript check: PASS.
- Expo Doctor: 20/20 checks PASS.
- Metro iOS Hermes JS bundle export: PASS.
- Metro Android Hermes JS bundle export: PASS.
- Expo Android prebuild: PASS using a synthetic key. Inspected generated
AndroidManifest.xml:com.google.android.geo.API_KEYentry appeared with the synthetic value. No credential was stored or committed. - Expo iOS prebuild: PASS, with Sign in with Apple entitlement. It is not a signed IPA.
- Expo config evaluation with key absent: PASS; no Maps config plugin injected and approved app identity preserved.
External store-release gates — not yet verified#
- Register/link
com.linknodesenergy.appto a real Expo EAS project ID, configure Apple Developer Team and App ID Prefix, provisioning certificates, Android keystore/Play App Signing and required Expo/Clerk native settings. - Create the restricted Google Maps SDK for Android key in the authorized Google Cloud project; bind package name plus signing SHA-1. Inject the key privately into the native EAS build environment.
- Supply a faithful, approved opaque 1024×1024 RGB PNG of the locked
apps/mobile/assets/linknodes-icon.svg; do not silently replace or reinterpret artwork. Setexpo.iconto this approved derivative only after visual approval. Prepare required screenshots and disclosures separately. - Supply production publishable Clerk/Supabase values and the approved HTTPS API URL to the EAS environment. Never insert service-role credentials or HYPE keys into an Expo client.
- Build signed iOS and Android development/test artifacts, verify on real devices (Clerk auth, login/logout, tenant isolation, map tiles, foreground location, API errors and offline states), then submit to TestFlight/Play Internal Testing and confirm store processing.
- Activate native Grafana crash reporting only after the Mobile preview entitlement, dedicated collector and signed-device crash tests pass. PostHog remains opt-in until ingestion/privacy are verified.
- Store approval, privacy disclosures, support URL, legal documents, rollback and signed build hash verification remain release gates.
Result: P7 code/build configuration is ready for review and safe to merge with all external secrets absent. This does not constitute completed signed Store releases, certified maps key, or store approvals.