准备工作

更新时间：2018-08-23 14:09:47

创建品牌APP

每个ISV客户，允许创建至多50个自有品牌APP。每个APP应用包括2个实际的APP：

新建自有品牌APP

需要四步才可以完成“自有品牌APP”的配置。

第一步：填写应用名称和包名

其中应用名称和包名后期可以修改。

第二步：配置SDK

首先选择合适的 “API Level”（SDK套餐包版本），其次勾选需要的SDK套餐项，然后平台会自动以此生成SDK配置包。
API Level 是SDK套餐项的功能版本等级，用来解决新老SDK套餐项不兼容问题，每个API Level包含一组SDK套餐项，不同API Level的SDK套餐项功能不同，建议使用默认的API Level3，查看版本详情；

第三步：选择服务

开启和配置需要的服务套餐项，然后平台会自动开启对应的服务。

第四步：下载SDK

IOS 集成 SDK

本 SDK 采用 cocoapods 管理依赖，建议采用 1.1.1 以上版本，SDK 的集成请参考以下步骤：

• 应用依赖描述文件

请将下载的IOS SDK Podfile 文件放到工程文件夹根目录, 并将 Podfile 文件中的 target 名称修改成和 xcode 工程的设置一致。

然后执行命令

pod update

Android 集成 SDK

我们推荐的开发工具为 Google 官方的 Android Studio (建议最新的3.0.x) 。SDK 的集成， 请参考以下步骤：

• 应用依赖描述文件

请把下载的Android SDK Pom dependency.gradle 文件放到 Module 的根目录下，然后在模块的根目录的 build.gradle 文件中添加如下代码

apply from:'dependency.gradle'

安全图片获取方法

(IOS)安全图片集成

下载后的安全图片的文件名为 yw_1222_07e8.jpg，请放到工程根目录，并将其拖入到 xcodeproj 根目录，如下二图所示：

• 安全图片位于工程根目录

• 安全图片位于 xcodeproj 根目录

• iOS 上为了安全性，安全图片需要和应用 bundleID 搭配使用，请确保工程的 bundleID和平台上创建 appKey 时输入的 bundleID （包名）保持一致。

问题排查

• 接入后运行工程 crash，报错 *** Terminating app due to uncaught exception 'com.openaccount.SecurityGuard.SECURITY_PICTURE_NOT_FOUND', reason: '(null)'

  1. 请检查应用创建时所输入的 bundleID 是否与当前工程 bundleID 一致

  2. 安全图片是否放到了工程根目录以及 xcodeproj 根目录

(Android)安全图片集成

下载后的安全图片的文件名为 yw_1222_xxxx.jpg ,请放到工程根目录,如下二图所示

• 安全图片，请放置于Android工程目录中的 res/drawable 下

• 签名配置, 因为 Android 端上，安全图片是需要和签名搭配使用的，所以要正确的配置签名：

android{

    signingConfigs {
        debug {
            storeFile file("./debug.keystore")
            storePassword '123456'
            keyAlias 'android'
            keyPassword '123456'
        }
    }

    buildTypes{
        debug {
            signingConfig signingConfigs.debug
        }
    }
}