用途:把 Solana 移动应用发布到 Solana dApp Store。流程分为一次性设置(铸造链上 App NFT)与每次发版的构建、签名、发布循环。
准备:需 Node 18 以上,安装 CLI:npm install -g @solana-mobile/dapp-store-cli@latest,也可用 npx;必须 1.0.1 或更新版本。
硬性约束:只接受 APK,.aab 会被拒绝,用 assembleRelease 而非 bundleRelease。keystore 与发布者钱包均不可更换,更新必须用同一密钥签名,App NFT 存于发布者钱包,丢失无法恢复。密钥库不应放进仓库;若同时上架 Google Play,应使用不同签名密钥。
一次性设置:先确定发布者密钥对,生成命令为 solana-keygen new --silent --outfile ~/.config/solana/publisher.json(--silent 抑制助记词输出)。将密钥对导入长期控制的钱包,在 https://publish.solanamobile.com 注册发布者并铸造 App NFT。注册约需 0.2 SOL(以门户实际报价为准),CLI 预检要求签名者至少 0.016 SOL。随后在 Dashboard > Settings > API keys 生成 API 密钥:export DAPP_STORE_API_KEY='paste-the-portal-api-key';也可用 --api-key-env <name> 或 --api-key-stdin。
构建签名 APK:EAS 用 eas build --platform android --profile dapp-store;本地签名用 (cd android && ./gradlew :app:assembleRelease),产物在 android/app/build/outputs/apk/release/app-release.apk。上传前用 "$ANDROID_HOME"/build-tools/<version>/apksigner verify --print-certs "$APK" 核对签名证书;更新时比对 SHA-256 指纹,并留意是否被误签为 CN=Android Debug。
发布:dapp-store --apk-file "$APK" --keypair ~/.config/solana/publisher.json --whats-new "Initial release"。可用 --apk-url 直传托管 APK,--verbose 打印 release 与 session 标识。脚本化时传 --idempotency-key 并复用于重试。非生产门户用 --portal-url 与 --rpc-url 同时指定。
续传:仅当运行未清理时用 dapp-store resume --release-id "$RELEASE_ID" --keypair <path>,--release-id 与 --session-id 只能二选一。
更新:需提升 versionCode(bare 项目在 android/app/build.gradle,Expo 在 expo.android.versionCode;cli.appVersionSource 为 remote 时用 autoIncrement)与 versionName(Expo 为 expo.version),并保持同签名密钥。包名须与列表一致。
Web 应用:用 npx solana-mobile@latest webshell init 与 webshell build,不要用 Bubblewrap;页面需 @solana-mobile/wallet-standard-mobile 0.5.1 或更新版本。
审核:人工审核通常需数个工作日,常见拒因包括未签名 APK、包名不符、缺少隐私政策与内容违规。其余细节暂未提供。