Solana Mobile React Native dApp 从零到上架终极新手指南（超详细·严谨·可执行）

目标：面向“vibe coding”开发者的从零到一完整实践，做到“照着本文即可开发和上架”。本指南基于 Solana Mobile Developers 官方文档最新内容，提供明确的步骤、命令、配置文件片段、注意事项与故障排查建议。

涵盖全流程：环境搭建 → 项目初始化 → 必备 polyfills → MWA 2.0 授权/签名/提交 → RPC/交易构建 → 测试与调试 → Expo/RN 构建签名 APK → 上架准备 → 发布到 Solana dApp Store → PWA 转 APK（可选）。

总览与关键概念

Solana Mobile Stack（SMS）核心组件：

• Mobile Wallet Adapter（MWA）：统一的“dApp ↔︎ 移动钱包”协议，提供授权、消息签名、交易签名与提交。[参考：官方开发者页][1]
• Seed Vault：面向钱包的安全密钥托管，dApp 侧不直接使用，开发 dApp 时用 MWA 即可。[参考：SMS 概览][2]
• Solana dApp Store：面向 Solana 生态的 Android 应用分发渠道，支持原生 APK 或将 PWA 封装为 APK。[参考：dApp Store 快速入门][3]

平台支持（MWA）：Android 原生/React Native ✅；Android Chrome 移动 Web ✅（配合 @solana/wallet-adapter-react）；iOS/Safari/Firefox/Opera/Brave ❌。[参考：MWA 支持矩阵][1]

一、开发环境搭建（Android/React Native/Expo）

本节直接给出基于官方指南的可执行步骤。

1. 安装 Android Studio（必需）

• 下载地址：https://developer.android.com/studio

• 安装后，打开 Android Studio，创建空项目，用于后续 SDK 工具管理（可选但推荐）。

• 在 Android Studio 中打开：Settings → Languages & Frameworks → Android SDK → SDK Tools，确保安装：

  • Android SDK Command-line Tools（最新）

  • Android SDK Build-Tools（如 34.0.0 或 35.0.0，后续签名与打包会用到）

    

• 如缺少 AAPT2 或 Build Tools，可在命令行安装（Mac 示例）：

~/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager "build-tools;34.0.0"
# 或更新到更高版本，例如 35.0.0
~/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager "build-tools;35.0.0"

2. 配置 JDK（JAVA_HOME）

• 若已安装 Android Studio，通常自带 JBR（JDK）。在 Android Studio 官方文档中查询路径，然后设置 JAVA_HOME。
• 若单独安装 JDK，推荐 OpenJDK 17：https://openjdk.org/projects/jdk/17/
• 设置环境变量（Mac 示例，按你的安装路径调整）：

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"