准备工作

更新时间:2018-05-24 23:41:50

创建品牌APP

每个项目中,允许创建一个自有品牌APP。每个APP应用包括4个实际的APP:

iOS
测试版本(用于开发调试)
正式版本(用于正式对外发布)
Android
测试版本(用于开发调试)
正式版本(用于正式对外发布)

新建自有品牌APP

15_45_06__04_28_2018副本.jpg | left | 719x391

填写应用名称和包名

应用名称后期可以修改,包名后期不可修改。

新建自有APP.png | left | 747x406

第一步:关联产品

需要三步才可以完成“自有品牌APP”的配置,第一步:关联产品。

此步骤页面里会列出该项目下创建的所有产品,如果希望该APP可以绑定某个产品,请开启关联状态的开关。
关联后,在APP端调用待配网设备的API时,可以获取到该产品的信息。

1、开发状态决定产品是否具备进入正式版APP的能力:
“开发中”,具备默认进入测试版APP的能力;
“已发布”,具备进入正式版APP的能力;
2、关联状态决定测试版APP和正式版APP是否显示该产品的配网入口;
若开关开启,且该产品开发中,则默认展示在测试版APP的配网入口;
若开关开启,且该产品已发布,则默认展示在正式版APP的配网入口;
若开关关闭,该产品无论开发中还是已发布,测试版和正式版APP配网入口都隐藏;

屏幕快照 2018-04-28 下午4.04.54.png | left | 747x527

第二步:用户账号

此步骤页面用来配置用户账号信息。
用户账号支持两种账号体系:内置账号体系和自有账号体系;
如果开发者没有自己的账号体系,可以采用内置账号体系,内置账号体系无需配置,已经内置在SDK套餐包中,提供文档调用方法;
如果开发者有自己的账号体系,可以采用自有账号体系,若勾选自有账号体系,则必须填写页面中的配置信息,否则自有账号将无法正常使用。

屏幕快照 2018-04-28 下午4.15.43.png | left | 747x582

第三步:SDK下载

此步骤页面用来选择和下载SDK

SDK配置项的选择和下载:

根据关联的产品,首先选择合适的 “API Level”(SDK套餐包版本),其次勾选和配置需要的SDK套餐项,然后平台会自动以此生成的SDK配置包;最后下载集成开发即可;

API Level 是SDK套餐项的功能版本等级,用来解决新老SDK套餐项不兼容问题,每个API Level包含一组SDK套餐项,不同API Level的SDK套餐项功能不同,先选择适合的API Level,查看版本详情

sdk下载.png | left | 747x882

IOS 集成 SDK

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

  • 应用依赖描述文件

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

image | center
然后执行命令

pod update

Android 集成 SDK

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

  • 应用依赖描述文件

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

'dependency.gradle'


![image | center](https://lark.alipay.com/api/filetransfer?url=https%3A%2F%2Fprivate-alipayobjects.alipay.com%2Falipay-rmsdeploy-image%2Fskylark%2Fpng%2F35b20df5-5580-4ef9-916a-9cb2294739f2.png "")


# <a name="ezqzpr"></a>安全图片获取方法


![16_34_22__04_28_2018.jpg | left | 747x536](https://cdn.yuque.com/lark/0/2018/jpeg/70319/1524904955641-afc52990-51e8-4d77-8510-1fc31ed64fc9.jpeg "")


## <a name="f0ebdo"></a>(IOS)安全图片集成
下载后的安全图片的文件名为 `yw_1222_07e8.jpg`,请放到工程根目录,并将其拖入到 `xcodeproj` 根目录,如下二图所示:

* 安全图片位于工程根目录
    ![image | center](https://lark.alipay.com/api/filetransfer?url=https%3A%2F%2Fprivate-alipayobjects.alipay.com%2Falipay-rmsdeploy-image%2Fskylark%2Fpng%2F8e07d541-87ac-4540-a0b5-b55ef2245b87.png "")

* 安全图片位于 `xcodeproj` 根目录
    ![image | center](https://lark.alipay.com/api/filetransfer?url=https%3A%2F%2Fprivate-alipayobjects.alipay.com%2Falipay-rmsdeploy-image%2Fskylark%2Fpng%2Ff791151c-ce24-498a-8b6b-5c9431e1de0a.png "")

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

#### <a name="问题排查"></a>问题排查

* 接入后运行工程 `crash`,报错 `*** Terminating app due to uncaught exception 'com.openaccount.SecurityGuard.SECURITY_PICTURE_NOT_FOUND', reason: '(null)'`
    1. 请检查应用创建时所输入的 `bundleID` 是否与当前工程 `bundleID` 一致
    2. 安全图片是否放到了工程根目录以及 `xcodeproj` 根目录


## <a name="sagamq"></a>(Android)安全图片集成
下载后的安全图片的文件名为 yw\_1222\_xxxx.jpg ,请放到工程根目录,如下二图所示

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



![image | center](//images/84269b3d-f4f1-4597-87ef-c9a4731513ca.png "")

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

```groovy
android{

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

    buildTypes{
        debug {
            signingConfig signingConfigs.debug
        }
    }
}

results matching ""

    No results matching ""