华为推送通道集成指南

华为推送通道是由华为官方提供的系统级推送通道。在华为手机上，推送消息能够通过华为的系统通道抵达终端，并且无需打开应用就能够收到推送。
华为推送只有在签名发布包环境下才可以收到推送消息
华为手机中的移动推送服务，必须升级到 2.5.3 以上版本
1. 获取华为推送秘钥
访问 华为开放平台。
注册/登录开发者账号。（如果您是新注册账号，需进行实名认证）.
在华为推送平台中新建应用。注意：应用包名需跟您在GIO集成的包名保持一致
2. 在project build.gradle的allprojects->repositories添加华为推送SDK的maven仓库 
allprojects {
    repositories {
        google()
        jcenter()
        mavenLocal()
        // 华为仓库
        maven { url 'http://developer.huawei.com/repo/' }
    }
}
3. 在app build.gradle添加华为通道SDK依赖
dependencies {
    ...
    //由于推送底层网络库依赖OkHttp3网络库，请添加OkHttp3依赖
    implementation 'com.squareup.okhttp3:okhttp:3.12.1'
    //推送SDK依赖
    implementation 'com.growingio.android:gtouch:$gtouch_version'
    //华为推送SDK依赖
    implementation 'com.growingio.android.gpush:gpush-huawei-adapter:$gtouch_version'
}
$gtouch_version 为最新SDK版本号，现最新的版本号为请参考SDK更新日志。
4. 配置AppID
android {
        ......
        defaultConfig {
            manifestPlaceholders = [
                PACKAGE_NAME        : "您的APP包名",
​
                GPUSH_HUAWEI_APP_ID : "华为推送的AppId(华为推送不需要AppKey)",
            ]
            ......
        }
        ......
}
5. 代码混淆
-ignorewarning
​
-keepattributes *Annotation*
​
-keepattributes Exceptions
​
-keepattributes InnerClasses
​
-keepattributes Signature
​
-keepattributes SourceFile,LineNumberTable
​
-keep class com.hianalytics.android.**{*;}
​
-keep class com.huawei.updatesdk.**{*;}
​
-keep class com.huawei.hms.**{*;}
​
-keep class com.huawei.android.hms.agent.**{*;}
6. 配置服务端AppID和AppSecret
7. 设置推送消息回执
在华为推送APP编辑界面配置回执，以便于我们GrowingIO更好的统计推送数据
目前单击【测试回执】，会提示“https，error"，请忽略并直接单击【提交】。
其中回调地址
https://messages.growingio.com/v1/callback/huawei
HTTPS证书
-----BEGIN CERTIFICATE-----
MIIGeDCCBWCgAwIBAgIQHjNQWZ7wMj3+VB9p4KLDpTANBgkqhkiG9w0BAQsFADCB
jzELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
A1UEBxMHU2FsZm9yZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTcwNQYDVQQD
Ey5TZWN0aWdvIFJTQSBEb21haW4gVmFsaWRhdGlvbiBTZWN1cmUgU2VydmVyIENB
MB4XDTE5MDkwMjAwMDAwMFoXDTIxMDkyMjIzNTk1OVowXTEhMB8GA1UECxMYRG9t
YWluIENvbnRyb2wgVmFsaWRhdGVkMR4wHAYDVQQLExVFc3NlbnRpYWxTU0wgV2ls
ZGNhcmQxGDAWBgNVBAMMDyouZ3Jvd2luZ2lvLmNvbTCCASIwDQYJKoZIhvcNAQEB
BQADggEPADCCAQoCggEBAKv9tDk+2fiPalexslgYbCLip4Ns/91Wt6X4Q6fGjuyr
8mIf/eG5yP9TeSgmTDdR8rMX2qFYfCw8Dt3KaWpfhL4zsafoz4AiaP9CMQCP8fwq
xjmUpcqnt2fguAyxbkZpyLnwKcHm7x/RJT1NdPBPylyIZ9WgmqKwhGoM8n3v1UaU
67jDjEj/eEm1WZVx45bauBSYVMW5xb5UL7fynmIhBkQJ3+l0lmGxki6Gte4ELAsp
nDJkckWBd/2/g2a8pA37VpwDrk2/aAwsucZaDIRDeuOtDIg0blJmbVpV0oMaIoLx
FdeUjgC3ACXOt87ajzdJz/ZFFobEBHCeUGf7JIhbyy8CAwEAAaOCAv8wggL7MB8G
A1UdIwQYMBaAFI2MXsRUrYrhd+mb+ZsF4bgBjWHhMB0GA1UdDgQWBBSlAD8AGhQj
8OlfefSZrxPv6ZVXlzAOBgNVHQ8BAf8EBAMCBaAwDAYDVR0TAQH/BAIwADAdBgNV
HSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwSQYDVR0gBEIwQDA0BgsrBgEEAbIx
AQICBzAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28uY29tL0NQUzAIBgZn
gQwBAgEwgYQGCCsGAQUFBwEBBHgwdjBPBggrBgEFBQcwAoZDaHR0cDovL2NydC5z
ZWN0aWdvLmNvbS9TZWN0aWdvUlNBRG9tYWluVmFsaWRhdGlvblNlY3VyZVNlcnZl
ckNBLmNydDAjBggrBgEFBQcwAYYXaHR0cDovL29jc3Auc2VjdGlnby5jb20wKQYD
VR0RBCIwIIIPKi5ncm93aW5naW8uY29tgg1ncm93aW5naW8uY29tMIIBfQYKKwYB
BAHWeQIEAgSCAW0EggFpAWcAdQD2XJQv0XcwIhRUGAgwlFaO400TGTO/3wwvIAvM
TvFk4wAAAWzw+80wAAAEAwBGMEQCIGa+uxrn7YC1pHF1e8ajPOSffMhJoEhupvQx
BQdeLEr6AiA6xE7pgIygEdLyI4zI/CF0H9M911aDZoPYERBHrmQL9QB3AESUZS6w
7s6vxEAH2Kj+KMDa5oK+2MsxtT/TM5a1toGoAAABbPD7zUsAAAQDAEgwRgIhAKWE
Z0RAxmqqM3bqPQmwNt02RTN7dEFB1xKZVmbP+CtAAiEAp+TfxTUlIxw3UinKhEjd
AZw7WDz/wiDZvR7y4vFGWXIAdQBVgdTCFpA2AUrqC5tXPFPwwOQ4eHAlCBcvo6od
BxPTDAAAAWzw+80nAAAEAwBGMEQCIE3arRcTs+XLCj5HDiDZhV1QkOMCqwnTp3NV
qkLXdecXAiA3xzd97tQnMIj6BIuYbfE+sONRUe4klZiFhwstlx4LTDANBgkqhkiG
9w0BAQsFAAOCAQEARChCUxNikK3PpBPy3vGbKeVra4TlbGKygI+8eaKrR5ShM3Ed
ehQuZKxtX0wrklRbWRdRXpBqXOz2NCWa8yFq1Z2Nu/14bUe/vXmxcF/1xTRvanPl
gD4bDlupkXK6asspDvy1lr+N4cYf63Q/UxkEbGFHbXdqsylZZNxrvy7Ax4cofMRN
CSF6KduF9Er34duYBCBUYlEXI0UvuuecQ1BWIebjaruDj4vDtYN1wOEUoAWine0a
BcFs6n04ii1vhi+4mtB5G9XnbakaNan/8iujJ8djRa9Pxs8lwIAhNayYnjUWqO+X
ImV7pBXFMpwSdsW0X1cqHsNFvpf/5MHiNpuBuw==
-----END CERTIFICATE-----
8. 厂商通道测试方法
将集成好的App（测试版本）安装在一台华为测试机上，并且运行App
保持App在前台运行，尝试扫码测试推送消息
如果应用收到消息，将App退到后台，并且杀掉所有App进程
再次进行测试推送消息，如果能够收到推送，则表明厂商通道集成成功
最好能根据官方推荐方式，先测通华为官方推送​
9. 兼容性
如果您的app已经集成了个推VIP或极光VIP版本等其他包含了华为推送sdk的第三方推送平台SDK，我们的android sdk也能兼容。
为了和个推兼容，我们将厂商通道独立打包。以华为推送通道为例，我们打包两个SDK：gpush-hms-agent和gpush-huawei-adapter。如果是从未接过个推、极光等VIP版本的用户可以直接添加华为推送通道依赖
implementation 'com.growingio.android.gpush:gpush-huawei-adapter:$gtouch_version'
如果是个推、极光等VIP版本的用户可以将华为官方SDK包gpush-hms-agent 排除出去。
implementation ('com.growingio.android.gpush:gpush-huawei-adapter:$gtouch_version'){
      exclude(group: 'com.growingio.android.gpush' , module: 'gpush-hms-agent')
}
最近更新 9 months ago