Mobile Platform as a Service:OPPO Push

1. Daftar untuk OPPO Push

2. Integrasikan OPPO Push

3. Uji OPPO Push

Daftar untuk OPPO Push

Buat akun di OPPO Open Platform dan ajukan layanan push. Untuk informasi lebih lanjut, lihat OPPO Push Platform User Guide.

Integrasikan OPPO Push

1. Instal komponen Push - OPPO. Proses instalasinya sama seperti menambahkan SDK Push. Untuk informasi lebih lanjut, lihat Tambahkan SDK. Komponen Push - OPPO hanya berisi kode adaptasi dan tidak menyertakan SDK OPPO Push.

2. Unduh SDK dari dokumentasi SDK OPPO dan integrasikan ke dalam proyek utama Anda. Versi yang saat ini didukung adalah 3.4.0. Untuk menggunakan versi yang lebih baru, Anda dapat memodifikasinya sesuai kebutuhan. SDK vendor biasanya kompatibel ke belakang. Jika Anda menemukan masalah kompatibilitas, bergabunglah dengan grup DingTalk 145930007362 untuk meminta dukungan versi baru tersebut.

3. Konfigurasikan AndroidManifest.xml. Jika Anda menggunakan integrasi berbasis komponen, tambahkan konfigurasi tersebut di proyek Portal. Ganti nilai com.oppo.push.app_key dan com.oppo.push.app_secret.

        <uses-permission android:name="com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE" />
        <uses-permission android:name="com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE"/>
   
        <application>
            <service
                android:name="com.heytap.msp.push.service.CompatibleDataMessageCallbackService"
                android:exported="true"
                android:permission="com.coloros.mcs.permission.SEND_MCS_MESSAGE"
                android:process=":push">
                <intent-filter>
                    <action android:name="com.coloros.mcs.action.RECEIVE_MCS_MESSAGE"/>
                </intent-filter>
            </service> 
   
            <service
                android:name="com.heytap.msp.push.service.DataMessageCallbackService"
                android:exported="true"
                android:permission="com.heytap.mcs.permission.SEND_PUSH_MESSAGE"
                android:process=":push">
                <intent-filter>
                    <action android:name="com.heytap.mcs.action.RECEIVE_MCS_MESSAGE"/>
                    <action android:name="com.heytap.msp.push.RECEIVE_MCS_MESSAGE"/>
                </intent-filter>
            </service>
            <meta-data
                android:name="com.oppo.push.app_key"
                android:value="Get from the OPPO Open Platform"
                />
            <meta-data
                android:name="com.oppo.push.app_secret"
                android:value="Get from the OPPO Open Platform"
                />
        </application>

4. Jika Anda menggunakan obfuscation, tambahkan aturan obfuscation berikut:

   • Tambahkan aturan obfuscation OPPO Push untuk semua jenis koneksi.

   • Jika Anda menggunakan jenis koneksi AAR, juga tambahkan aturan obfuscation mPaaS.

5. Jika Anda menggunakan OPPO Push versi 3.4.0, tambahkan dependensi berikut:

   implementation 'commons-codec:commons-codec:1.15'

Uji OPPO Push

1. Setelah mengintegrasikan OPPO Push, jalankan aplikasi Anda di ponsel OPPO dan pastikan metode inisialisasi dipanggil. Untuk informasi lebih lanjut, lihat Inisialisasi Layanan Push Pesan. SDK push secara otomatis memperoleh dan melaporkan token vendor untuk OPPO Push.

2. Dorong pesan uji setelah menghentikan proses aplikasi:

   • Jika Anda menerima pesan tersebut, integrasi berhasil.

   • Jika Anda tidak menerima pesan tersebut, ikuti langkah-langkah berikut untuk memecahkan masalah.

Pecahkan masalah

1. Pastikan Anda telah menambahkan konfigurasi AndroidManifest.xml. Periksa apakah nilai com.oppo.push.app_key dan com.oppo.push.app_secret sesuai dengan nilai di OPPO Open Platform.

2. Di Konsol mPaaS, pastikan channel OPPO telah diaktifkan. Untuk informasi lebih lanjut, lihat Konfigurasikan channel push OPPO. Periksa apakah konfigurasi tersebut sesuai dengan yang ada di OPPO Open Platform.

3. Periksa log logcat untuk memecahkan masalah:

   1. Pilih proses push, filter berdasarkan mPush.PushProxyFactory, dan periksa entri log berikut:

      D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.oppo.Creator

      Jika entri log ini tidak ada, kemungkinan terdapat masalah pada komponen Push - OPPO. Pastikan Anda telah menambahkannya dengan benar.

   2. Pilih proses push dan filter berdasarkan mOPPO. Periksa apakah token vendor untuk OPPO Push telah diperoleh. Jika entri log berisi "OPPO onRegister error" atau `responseCode` selain 0, pendaftaran OPPO Push gagal. Untuk informasi lebih lanjut tentang kode kesalahan, lihat bagian definisi kode kesalahan dalam dokumen OPPO Push Error Codes.

   3. Pilih proses utama dan filter berdasarkan report channel token. Periksa apakah token vendor OPPO telah dilaporkan dengan sukses. Jika Anda melihat entri log berikut:

      report channel token error: xxxx

      Hal ini menunjukkan bahwa pelaporan token gagal. Periksa apakah base64Code dalam file konfigurasi mPaaS memiliki nilai. Selain itu, periksa apakah signature APK yang Anda unggah untuk mendapatkan file konfigurasi tersebut sesuai dengan signature aplikasi saat ini.

   4. Pilih proses push, filter berdasarkan mcssdk, dan lihat log internal untuk OPPO Push.

Pertanyaan lainnya

Model dan versi sistem apa saja yang didukung oleh OPPO Push?

OPPO Push mendukung model OPPO yang menjalankan ColorOS 3.1 atau versi yang lebih baru, model OnePlus 5/5T atau versi yang lebih baru, serta semua model realme.

ColorOS adalah sistem operasi seluler dari OPPO yang merupakan versi Android yang telah dikustomisasi dan dioptimalkan secara mendalam.