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/代理影响布局是按网络出口判断的结果。

协议接收可使用标准请求测试的合成数据回显检查,不创建用户或写入业务数据。实际构建、签名与商店发布需要分别验证,不把配置文件存在视为已上架。