我们自己有六个 App 上架了 Solana dApp Store,大多数一开始都是网页应用。现在把网页包成 Android App 已经是最简单的一步:Solana Mobile 提供免费工具,一个命令就能完成。真正花时间的,是网站放进 App、在真的 Seeker 上跑起来之后,那些行为变得不一样的地方。这篇就是我们希望当初就有的清单。
包装本身只要一个命令
Solana Mobile 的命令行工具会在你的网站外面包一层 WebView 外壳,并签好 APK:
npx solana-mobile@latest webshell init my-app --manifest https://your-app.com/manifest.json
npx solana-mobile@latest webshell build my-app
init 从你的网页 manifest 读取名称和图标;没有签名 keystore 的话会帮你建一个。build 产出 app/build/outputs/apk/release/app-release.apk。Solana Mobile 现在推荐用这种 WebView 外壳,而不是旧的 Trusted Web Activity(Bubblewrap)做法:外壳不需要设定 Digital Asset Links,Solana 钱包请求也由外壳直接处理;而浏览器的网络限制可能让 TWA 里的钱包连接失效。
如果你的应用通过 @solana-mobile/wallet-standard-mobile 使用 Mobile Wallet Adapter,要升级到 0.5.1 或以上,它才认得出外壳。
到这里都很快。我们拿一个提供 Google 登录的线上 dApp 试,在 Seeker 上完全正常地打开了。然后我们点了「Continue with Google」。
1. Google 和其他社交账号登录:离开 App 后就回不来
在外壳里,凡是不属于你应用本身网址的连结,都会在系统浏览器打开。这个默认是对的:陌生网站不会跑进你的 App。但 Google 登录正好就是这种连结。我们在 Seeker 上看到的是:
- 用户点「Continue with Google」。
- Chrome 打开 Google 的选账号页面,用户在 Chrome 里选了账号。
- 登录在 Chrome 里完成,而不是在 App 里。回到 App,画面一直停在「Logging in…」。
把 Google 页面留在 WebView 里也行不通:Google 会挡掉嵌入式 WebView 里的登录。真正有效的修法:
- 把登录结果带回 App。 用 Custom Tab 打开登录页,再通过深层链接或 Android App Link 回到 App;你的登录服务商必须接受这个回调地址。这是外壳的原生开发工作,不是改网页就能解决。
- 在 Seeker 上把钱包当成主要登录方式。 每台 Seeker 都有钱包(Seed Vault)。通过 Mobile Wallet Adapter 做 Sign In With Solana,会打开手机钱包让用户确认,然后直接回到你的 App;对加密用户来说,这本来就是他们期待的登录方式。Email 登录留作备用:在 App 里输入一次性验证码,不需要浏览器。
如果你的网页应用只有 Google 和 Email 登录,先测这一项。它决定了你的 App 能用,还是每个用 Google 的用户都被挡在门外。
2. 弹出窗口和新分页也会跑去浏览器
window.open 和 target="_blank" 也是同样的规则。刷卡付款组件、法币入金、「分享到 X」按钮、客服聊天,常常都是这样打开的。有些没问题(分享连结本来就该打开 X);有些就不行:在 Chrome 里完成的付款,你的 App 根本不知道发生过。把每个会打开东西的流程都走一遍,决定它该留在 App 里,还是出去之后要有办法回来。
3. 钱包连接:要在真机上测,不能只靠电脑模拟
钱包的行为,是在电脑上测不出来的部分。在 Seeker 上要确认:
- 连接时直接用手机的钱包,不需要扫 QR 码、也不需要跳到浏览器;
- 签交易、签讯息之后都会回到 App;
- 用户拒绝签名时有正确处理,而不是一直转圈;
- 签名途中手机锁屏,App 之后还能正常用。
4. 让 App 感觉像网站的那些小地方
- 返回键。 Android 的返回键应该在你的应用里回上一页,只有在第一个画面才离开 App。每个画面都要检查,包括弹窗。
- 起始页。 让 App 打开你应用的主画面(
/play、/app),而不是营销首页。 - 启动画面、图标和状态栏。 都由你的 manifest 产生;深色应用配白色
theme_color,就会出现一条白色的状态栏。 - 你的网站是即时的。 外壳加载的是你的线上网站,所以网页更新不用发新 APK 就会到用户手上。这也代表网站一部署坏,App 也立刻跟着坏。
5. 上架时容易踩的坑
- 发布者账号是你的,而且要身份验证。 dApp Store 的发布者后台在你新增 App 之前,会要求 KYC(个人)或 KYB(公司)。让应该拥有这个 App 的人或公司自己来做。
- 签名密钥要永远留着。 每次更新都必须用同一把密钥签名。keystore 或密码弄丢了,App 就再也不能更新。如果同时上 Google Play,两边要用不同的密钥。
- 包名不能改。 一开始就定好,例如
com.yourteam.app。 - 每次更新的版本号都要更大。 在外壳里改
gradle.properties的SOLANA_MOBILE_VERSION_CODE,再重新打包。 - 审核时间。 Solana Mobile 说新 App 要 3 到 4 个工作日,更新 1 到 2 个工作日。商店不抽成。
送审前的检查清单
- 每种登录方式在真的 Seeker 上都能用,而且会回到 App。
- 连接钱包、签交易、签讯息、拒绝签名都正常。
- 每个离开 App 的连结或弹窗,都是你本来就想让它离开的。
- 每个画面的返回键都正常。
- 图标、横幅、截图和说明都准备好了。
- keystore 和密码备份在两个地方。
如果你不想自己来
这正是我们帮其他团队做的事:包装、修好登录和钱包、真机测试、商店资料,以及陪你走完发布者后台,最后用你自己的账号发布。价格从 US$750 起,详见我们的服务页。