Головна сторінка Огляд Довідка
Реєстрація Увійти
xuchaoqing
/
fastadmin_tailored
1
0
Відгалуження 0
Файли Проблеми 0 Запити на злиття 0 Wiki
Дерево: e015a8a371
Гілки Теги
fastadmin_ta...
/
docs
/
channel
/
android_app.md

android_app.md 8.3 KB
Історія Запис

Android APP渠道配置

概述

Android APP是谷歌安卓生态系统中的重要应用形态，具有庞大的用户基础和多样化的分发渠道。本文档描述了Android APP渠道的完整配置流程。

基本信息

  • 渠道标识: android_app
  • 渠道名称: Android APP
  • 渠道类型: 移动应用
  • 所属分组: 移动应用 (mobile_app)

配置要素

1. 基本配置

// 渠道基本信息
'channel' => 'android_app',
'name' => 'Android APP',
'status' => true, // 开启/关闭
'description' => 'Android移动应用平台接入'

2. 应用平台配置

必填参数

  • Package Name: 应用包名
  • App签名: 应用签名信息
  • 推送配置: 推送服务配置（可选）

配置示例

'android_config' => [
    'package_name' => 'com.yourcompany.yourapp',
    'app_signature' => 'SHA1:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD',
    'google_play_id' => 'com.yourcompany.yourapp',
    'push_config' => [
        'service' => 'fcm', // fcm/jpush/umeng等
        'server_key' => 'your_server_key',
        'sender_id' => 'your_sender_id'
    ]
]

获取方式

  1. 在Android Studio中创建项目
  2. 生成应用签名
  3. 在Google Play Console中创建应用
  4. 配置推送服务（如需推送功能）

3. 支付配置

Android APP支持以下支付方式：

3.1 支付宝支付 ✅ (推荐)

  • 状态: 开启
  • 优先级: 1
  • 配置要求:
    • 需要开通支付宝商户号
    • 配置移动应用支付
    • 设置支付证书
'payment_config' => [
    'alipay' => [
        'enabled' => true,
        'app_id' => '支付宝应用ID',
        'private_key' => '应用私钥',
        'public_key' => '支付宝公钥',
        'notify_url' => '支付回调地址'
    ]
]

3.2 微信支付 ✅

  • 状态: 开启
  • 优先级: 2
  • 配置要求:
    • 需要开通微信支付商户号
    • 配置移动应用支付
    • 设置回调地址
'payment_config' => [
    'wechat' => [
        'enabled' => true,
        'app_id' => '微信开放平台AppID',
        'mch_id' => '商户号',
        'key' => '商户密钥',
        'cert_path' => '证书路径',
        'notify_url' => '支付回调地址'
    ]
]

3.3 余额支付 ✅

  • 状态: 开启
  • 优先级: 3
  • 说明: 用户使用账户余额进行支付
'payment_config' => [
    'balance' => [
        'enabled' => true,
        'min_amount' => 0.01, // 最小支付金额
        'max_amount' => 50000, // 最大支付金额
    ]
]

3.4 不支持的支付方式 ❌

  • 线下支付
  • 货到付款

4. 登录配置

4.1 自动登录

  • 状态: 开启/关闭
  • 说明: 进入应用后，用户将会自动授权登录，未注册用户将会自动注册
'login_config' => [
    'auto_login' => false, // Android通常不建议自动登录
    'auto_register' => true,
]

4.2 绑定手机号

  • 状态: 开启/关闭
  • 说明: 授权登录后，未绑定手机号的用户，将会立即提醒绑定手机号
'login_config' => [
    'force_mobile' => true,
    'mobile_verify' => true, // 手机号验证
]

4.3 第三方登录

  • Google登录: 推荐使用
  • 微信登录: 需要配置微信开放平台
  • 其他第三方登录: 根据需要配置
'login_config' => [
    'google_login' => [
        'enabled' => true,
        'client_id' => 'your_google_client_id',
        'server_client_id' => 'your_server_client_id'
    ],
    'wechat_login' => [
        'enabled' => true,
        'app_id' => '微信开放平台AppID',
        'app_secret' => '微信开放平台AppSecret'
    ]
]

5. 功能特性

功能 支持状态 说明
支付功能 ✅ 支持支付宝支付、微信支付、余额支付
分享功能 ✅ 支持分享到各种平台
定位功能 ✅ 支持获取用户地理位置
拍照功能 ✅ 支持调用摄像头拍照
推送功能 ✅ 支持FCM、极光推送等

配置流程

1. Google Play Console配置

  1. 注册开发者账号

  2. 创建应用

    • 在Google Play Console中创建新应用
    • 填写应用基本信息
    • 设置应用图标和截图

  3. 配置应用信息

    • 应用描述
    • 分类设置
    • 内容分级

  4. 版本管理

    • 创建版本
    • 上传APK/AAB文件
    • 提交审核

2. 系统后台配置

  1. 基本信息配置

    渠道状态: 开启
渠道名称: Android APP
渠道描述: Android移动应用平台

  2. 平台参数配置

    Package Name: com.yourcompany.yourapp
App签名: SHA1:AA:BB:CC:DD...
Google Play ID: com.yourcompany.yourapp

  3. 支付方式配置

    微信支付: 开启
支付宝支付: 开启
余额支付: 开启
货到付款: 关闭

  4. 登录方式配置

    自动登录: 关闭
绑定手机号: 开启
Google登录: 开启
微信登录: 开启

3. 开发配置

  1. 应用代码配置

    // Application.java
public class MyApplication extends Application {
   @Override
   public void onCreate() {
       super.onCreate();
           
       // 配置API基础URL
       ApiManager.init("https://your-domain.com/api");
           
       // 配置第三方SDK
       initThirdPartySDKs();
   }
}
    1. 登录授权 ```java // Google登录 private void signInWithGoogle() { GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN) .requestIdToken(getString(R.string.server_client_id)) .requestEmail() .build();

    GoogleSignInClient client = GoogleSignIn.getClient(this, gso); Intent signInIntent = client.getSignInIntent(); startActivityForResult(signInIntent, RC_SIGN_IN); } ```

  2. 支付调用

    // 支付宝支付
private void payWithAlipay(String orderInfo) {
   Runnable payRunnable = () -> {
       PayTask alipay = new PayTask(this);
       Map<String, String> result = alipay.payV2(orderInfo, true);
           
       runOnUiThread(() -> {
           handlePayResult(result);
       });
   };
       
   Thread payThread = new Thread(payRunnable);
   payThread.start();
}

    测试验证

    1. 开发环境测试

    • 使用Android Studio进行开发调试
    • 测试登录授权流程
    • 测试支付功能

    2. 内部测试

    • 创建内部测试版本
    • 邀请测试用户
    • 验证完整业务流程

    3. 接口测试

    # 测试登录接口
curl -X POST "https://your-domain.com/api/login" \
-H "Content-Type: application/json" \
-d '{"token":"Google登录token","channel":"android_app"}'

# 测试支付接口
curl -X POST "https://your-domain.com/api/payment/create" \
-H "Content-Type: application/json" \
-d '{"amount":100,"channel":"android_app","payment_type":"alipay"}'

注意事项

  1. Google Play政策

    • 严格遵守Google Play政策
    • 不能包含违规内容
    • 支付功能需要合规

  2. 权限管理

    • 合理申请应用权限
    • 适配Android权限模型
    • 处理权限拒绝情况

  3. 第三方SDK

    • 确保SDK版本兼容
    • 及时更新SDK版本
    • 注意SDK隐私合规

  4. 多渠道发布

    • 适配不同应用商店
    • 考虑渠道包区别
    • 统计渠道来源

常见问题

Q1: 如何配置Google登录？

A: 在Google Cloud Console中配置OAuth 2.0客户端ID，获取客户端ID和密钥。

Q2: 为什么支付功能不工作？

A: 检查商户号配置、签名配置，确保回调地址可访问。

Q3: 如何处理推送通知？

A: 配置FCM服务，在应用中请求推送权限，处理推送消息。

Q4: 如何适配不同Android版本？

A: 设置合适的targetSdkVersion，适配不同版本的API变化。

相关链接