应用配置

本指南全面介绍 OpenDev 中应用配置的各个方面，从基础设置到配置包生成和分发。

概述

OpenDev 中的应用配置包括：

• 基本应用信息
• 渠道和发行主体绑定
• 商品配置
• 支付设置
• 配置包生成和分发

访问应用配置

1. 登录 OpenDev 平台
2. 前往侧边栏的 应用
3. 点击您的应用
4. 使用配置标签页进行导航

配置标签页

1. 基本信息

应用配置的基础。

字段

管理应用密钥

Development:  用于本地开发
Testing:      用于 QA/预发布环境
Production:   用于正式应用

每个环境有独立的密钥，防止开发过程中意外访问生产环境。

2. 渠道标签页

配置哪些渠道分发您的应用。

绑定渠道

1. 点击 绑定渠道
2. 从可用渠道中选择
3. 配置渠道特定设置
4. 保存绑定

渠道设置

渠道绑定示例

{
  "channelKey": "google_play_global",
  "enabled": true,
  "oauth": {
    "providers": ["google", "facebook"]
  },
  "payment": {
    "provider": "google_play"
  }
}

3. 商品标签页

配置应用中可用的商品。

商品配置

1. 点击 添加商品
2. 选择要包含的商品档位
3. 配置应用特定设置
4. 保存配置

商品设置

4. 支付标签页

配置应用的支付处理。

支付平台

启用和配置每个平台：

Stripe（Web/桌面端）

{
  "platform": "stripe",
  "enabled": true,
  "publishableKey": "pk_live_xxx",
  "webhookSecret": "whsec_xxx"
}

Google Play（Android）

{
  "platform": "google_play",
  "enabled": true,
  "packageName": "com.yourcompany.app"
}

Apple（iOS）

{
  "platform": "apple",
  "enabled": true,
  "bundleId": "com.yourcompany.app"
}

微信支付（中国区）

{
  "platform": "wechat_pay",
  "enabled": true,
  "mchId": "1234567890"
}

5. 配置包标签页

生成和管理客户端分发的配置包。

配置包

配置包包含什么？

配置包包含所有客户端配置：

{
  "app": {
    "id": "app_xxxxxxxxxxxx",
    "name": "My Application",
    "version": "1.0.0"
  },
  "channel": {
    "key": "google_play_global",
    "name": "Google Play Global"
  },
  "oauth": {
    "providers": [
      {
        "id": "google",
        "clientId": "xxxxx.apps.googleusercontent.com",
        "scopes": ["email", "profile"]
      }
    ]
  },
  "payment": {
    "enabled": true,
    "provider": "google_play"
  },
  "products": [
    {
      "id": "pro_monthly",
      "name": "Pro Monthly",
      "platformId": "pro_monthly_sub"
    }
  ],
  "services": {
    "api": "https://api.yourdomain.com",
    "cdn": "https://cdn.yourdomain.com"
  }
}

生成配置包

1. 前往 配置包 标签页
2. 点击 生成配置包
3. 选择配置选项：

1. 点击 生成
2. 下载或复制配置

配置包分发方式

1. 直接下载

• 下载 JSON 文件
• 在构建时打包到应用中
• 简单但需要更新应用来修改配置

2. CDN 发布

• 发布到 CDN 端点
• 应用启动时获取
• 无需发布新版本即可更新配置

const configUrl = 'https://cdn.yourdomain.com/config/app_xxx/prod/android.json';
const config = await fetch(configUrl).then(r => r.json());

3. API 端点

• 运行时通过 API 获取
• 最灵活
• 启动时需要网络

const config = await api.get('/config', {
  headers: {
    'X-App-ID': appId,
    'X-Channel-Key': channelKey,
    'X-Environment': 'production'
  }
});

最佳实践

配置策略

1. 环境隔离

• 开发中不使用生产环境密钥
• 每个环境独立的配置文件
• 清晰的命名规范

1. 安全性

• 客户端配置中不包含敏感密钥
• 敏感操作使用服务器端代理
• 验证配置完整性

1. 性能

• 本地缓存配置
• 实现刷新策略
• 优雅处理离线情况

1. 可维护性

• 记录配置变更
• 版本控制配置模板
• 在 CI/CD 中自动生成配置

故障排查

配置未加载

可能原因：

• 网络问题
• 错误的 URL/路径
• 配置未发布

解决方案：

1. 检查 CDN URL 是否正确
2. 验证配置已发布
3. 通过直接 URL 访问测试
4. 检查应用权限

OAuth 不工作

可能原因：

• 缺少 OAuth 配置
• 错误的 Client ID
• 渠道不匹配

解决方案：

1. 验证配置中的 OAuth 提供商
2. 检查 Client ID 与平台匹配
3. 确保渠道 Key 正确

支付问题

可能原因：

• 支付未启用
• 错误的平台配置
• 商品 ID 不匹配

解决方案：

1. 验证配置中支付已启用
2. 检查平台特定设置
3. 将商品 ID 与平台控制台匹配

相关文档

• 创建应用
• 商品档位
• 渠道商品配置
• 发行主体与渠道