App 发行渠道¶
基本渠道¶
发行渠道通过公共请求头的X-Channel传递。固定使用下列英文代码,显示名称可以按语言切换,代码不翻译。此表描述安装包的发行来源,不表示用户所在国家、界面语言或登录方式。
| 地区 | 渠道 | X-Channel/APP_CHANNEL | 平台 |
|---|---|---|---|
| 国内 domestic | 小米 | xiaomi |
android |
| 国内 domestic | vivo | vivo |
android |
| 国内 domestic | 华为 | huawei |
android |
| 国内 domestic | OPPO | oppo |
android |
| 国内 domestic | 应用宝 | yingyongbao |
android |
| 国内 domestic | 荣耀 | honor |
android |
| 国内 domestic | 百度 | baidu |
android |
| 海外 overseas | 谷歌(Google Play) | google_play |
android |
| 全球 global | 苹果(App Store) | app_store |
ios |
可下载机器可读渠道清单,包含version和九个条目;每项有code、region、platform、中英日韩names。Java构建把同一文件打包为渠道资源,后台通过版本渠道接口读取。新增渠道需同步清单、文档及客户端打包预设。
七个国内Android渠道、海外Google Play和全球App Store共九项,不拆国内/国际苹果包。region是发行分类(domestic/overseas/global),不是当前用户布局。google_play/app_store仅标记发行商店,不启用Google/Apple登录或支付。
客户端配置¶
APP_ENV=dev|staging|prod选择运行环境。- 正式连接的当前布局由闪屏配置返回layoutRegion,CN国内、其他识别地区国际、未知默认国内;APP_REGION只保留兼容/明确本地预览用途,不覆盖成功读取的后端布局。
APP_CHANNEL选择发行渠道,统一请求层把它写入X-Channel;不按手机品牌、系统语言或用户选择的国家推断。- 界面语言仍由
Accept-Language表达,切换语言不改变渠道。渠道配置是公开信息,不放密钥。
Flutter的config/channels/<渠道代码>.json继续标识发行来源。Android分包及iOS单包不变,启动后由服务端IP结果选择布局;切换语言不改变发行渠道。后端与管理后台已部署,Flutter完成范围以独立验收为准。
Android开发配置构建示例:
# 在Flutter工程根目录执行,生成小米/应用宝/Google Play渠道的release APK
sh tool/build_android_release.sh domestic dev xiaomi
sh tool/build_android_release.sh domestic dev yingyongbao
sh tool/build_android_release.sh overseas dev google_play
脚本拒绝渠道与地区不匹配、未知渠道及苹果渠道APK。产物包含环境、地区和渠道,例如app-dev-domestic-xiaomi-release.apk。原domestic dev、overseas dev命令继续用于不指定商店的开发包;生产构建须显式指定实际渠道。
iOS采用苹果渠道配置,例如使用开发配置编译验证:
flutter build ios --release --no-codesign \
--dart-define-from-file=config/dev.json \
--dart-define-from-file=config/channels/app_store.json \
--dart-define=ENABLE_HTTP_LOG=false \
--dart-define=ENABLE_LANGUAGE_PREVIEW=false
正式发行使用实际prod环境地址和对应渠道配置,继续要求HTTPS/JWE及有效发布签名。配置渠道不会自动上传应用商店、生成商店资质或完成发布签名;当前预设不包含服务端秘密。
开发与后台标识¶
dev继续作为开发/预发通用测试标识,不占用上述九个商店渠道;管理网页继续固定使用admin_web,不得当成App发行渠道。原文档中的official、testflight不列入本次基本发行名单。通用元数据仍校验X-Channel格式;登录及VIP准入额外要求上述正式渠道与平台匹配,dev仅明确开发且非prod允许,未知或不匹配返回400 INVALID_APP_CHANNEL,不视为VIP门槛关闭。其他匿名目录/版本接口的既有未知渠道契约保持。
验证与使用边界¶
后台版本管理按九个渠道筛选并创建即发布,选择渠道自动显示发行分类和平台;苹果显示全球、按访问地区展示,版本仍仅一份。列表region筛选支持global,App升级仍按渠道和构建号,不按IP拆发布目标。生命周期及部署状态见版本管理。
新客户端协议目录固定传layoutPolicy=ip-v1,使用与闪屏一致的IP范围;无参数旧客户端仍兼容渠道选版(苹果保留原国际规则)。后台渠道global不改变协议配置的domestic/overseas两套正文。IP不决定支付地区、币种、用户资料国家或法律适用,VPN/代理影响布局是按网络出口判断的结果。
协议接收可使用标准请求测试的合成数据回显检查,不创建用户或写入业务数据。实际构建、签名与商店发布需要分别验证,不把配置文件存在视为已上架。