Integrate a security image

Overview

When you develop an application using the latest App SDK from the platform, you must integrate the matching security image.

Integrate an iOS security image

1. Go to the self-branded app page.
2. If you are upgrading an existing project to a new SDK version, first click Update security image. Then, click Download security image for iOS to obtain the image that is compatible with the new SDK version.
   Note If you are developing an app from scratch in a newly created project, download the latest version of the App SDK from the platform page. Click Download Security Image to obtain the latest security image that corresponds to the SDK.
3. Place the security image in the root directory of the application project.
4. Open Xcode and drag the security image to the root directory of the xcodeproj.
5. Set the Bundle Identifier for the iOS project.
   For security purposes, the project's Bundle Identifier must match the bundleID (package name) that you specified when you created the self-branded app.

Integrate an Android security image

1. Go to the self-branded app page.
2. Upload the signed APK file.

   All Android applications must be signed. You can find instructions online for generating a signature file.

3. Click Upload apk to get security image for Android.
4. Place the security image in the \src\res\drawable directory of your Android project.
5. Verify the signature.

   The Android security image must be used with its corresponding signature.

   Note If your product is sold in markets outside China and your Android application will be listed on Google Play, do not use the Google Play App Signing service. The security image must be paired with your original signature. Using the Google Play App Signing service will prevent your application from starting.

   Confirm that the build.gradle file contains the following code. Ensure that this signature configuration matches the one in the APK file that you uploaded in Step 3.

   android{
   
       signingConfigs {
           release {
               v2SigningEnabled true
               storeFile file("debug.jks")
               storePassword '123456'
               keyAlias 'ray_ni'
               keyPassword '123456'
           }
       }