Acceda rápidamente a Jiguang Push (biblioteca de terceros) en proyectos de Android

I. Introducción

        Dado que puedo entrar en contacto con conocimientos relevantes en el trabajo, aprendí a usar Aurora Push en los últimos dos días. También encontré muchos problemas durante el proceso de aprendizaje, por lo que pretendo resumirlos brevemente.

        Entonces, ¿por qué debo acceder a Jiguang Push? Aquí hay una breve respuesta a esta pregunta. La razón principal es que la puntualidad de la inserción de mensajes implementada por Aurora Push es relativamente alta y ahorra tiempo y energía para los teléfonos móviles de los usuarios; pero si usted mismo desarrolla un servicio de inserción, el desarrollo simple puede llevar a una pérdida de tiempo y energía. problemas de consumo, porque el mensaje La implementación de push sigue siendo relativamente complicada. Si un individuo o un grupo pequeño necesita usarlo, no creo que sea necesario construir una rueda, creo que un equipo grande puede hacerlo si es necesario.

2. Acceda rápidamente a las notas push de Jiguang (las más simplificadas) en el proyecto de Android

        La mayoría de las notas aquí provienen de documentos oficiales. Si hay discrepancias en el contenido, consulte los documentos oficiales.

        Entorno necesario: Android Studio, una cuenta JiguangPush registrada.

        paso 1

        Cree un proyecto en Android Studio y luego registre el nombre del paquete del proyecto, suponiendo que el nombre del paquete sea com.szu.weather.

        paso 2

        Cree una aplicación en el sitio web oficial de JiguangPush, el proceso deberá usar el nombre del paquete. Si no lo entiende, puede consultar los pasos detallados en el sitio web oficial . Una vez que la aplicación se haya creado correctamente, obtendrá una AppKey, suponiendo que la AppKey sea g4u8ej62m7047000040aw5hd.

        paso 3

        Configure el gradle del Módulo: Hay tres lugares que deben llenarse aquí.

        ① Agregar llaves de configuración predeterminadas

ndk {
    //选择要添加的对应 cpu 类型的 .so 库。
    abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a'
    // 还可以添加 'x86', 'x86_64', 'mips', 'mips64'
}

        Como se muestra en la imagen (recuerde escribir el nombre del paquete en la imagen, no xxx.xxx):

        ② Agregar después de ndk (aquí, debe completar su AppKey, no la mía)

manifestPlaceholders = [
    JPUSH_PKGNAME : applicationId,
    JPUSH_APPKEY : "g4u8ej62m7047000040aw5hd",
    JPUSH_CHANNEL : "developer-default",
]

        Después de agregar, como se muestra en la figura:

        ③ Agregue "cn.jiguang.sdk:jpush:5.0.3" entre las llaves de las dependencias. Dado que el documento oficial dice que el paquete JCore se puede extraer automáticamente de la versión 5.0.0, no necesitamos configurar JCore adicionalmente. Después de agregar, como se muestra en la figura:

        Después de completar ③, ya no es necesario importar la biblioteca de terceros Jiguang Push a través del paquete jar.

        Etapa 4

        Configure un Servicio personalizado y un Receptor personalizado de acuerdo con la recomendación del documento oficial. Pero no se preocupe, estas dos clases personalizadas deben declararse como públicas, de lo contrario habrá un problema de retroceso. Fui descuidado y no agregué public.Me enteré de cómo ejecutar el proyecto de Android No se puede crear una instancia de la aplicación, IllegalAccessException más tarde para resolver este problema.

        ①El servicio debe heredar de cn.jpush.android.service.JCommonService. Si no lo entiende al principio, puede dejar este archivo vacío. Por ejemplo,

        Luego debe registrarse en el archivo AndroidManifest.xml:

        ②El receptor debe heredar de cn.jpush.android.service.JPushMessageReceiver. Esta clase es similar al Servicio anterior y puede dejarla vacía si no la entiende al principio. Por ejemplo,

import cn.jpush.android.service.JPushMessageReceiver;

public class DemoReceiver extends JPushMessageReceiver {
}

        Pero, de hecho, esta clase es para recibir mensajes push específicos y puede usar Bundle en esta clase para analizar y reutilizar la promoción.

        En consecuencia, el archivo AndroidManifest.xml también necesita registrar el receptor:

        Paso 5

        Cree una clase de aplicación, herede de android.app.Application y luego inicialice el servicio push en el método onCreate, por ejemplo

import android.app.Application;
import android.content.Context;

import cn.jiguang.api.utils.JCollectionAuth;
import cn.jpush.android.api.JPushInterface;

public class XXXApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        JPushInterface.setDebugMode(true);

        Context context = this;
        JPushInterface.init(context);

        JCollectionAuth.setAuth(context, true); //如初始化被拦截过，将重试初始化过程
    }
}

        Esta clase también debe registrarse en el archivo AndroidManifest.xml

        Paso 6

        Declarar permisos básicos en el archivo AndroidManifest.xml, el funcionario dijo que es necesario

    <!-- 记得修改相应的包名(共有两处需要修改) -->
    <permission android:name="com.szu.weather.permission.JPUSH_MESSAGE" android:protectionLevel="signature" /> 
    <uses-permission android:name="com.szu.weather.permission.JPUSH_MESSAGE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

        paso 7

        Recuerda solicitar permiso en MainActivity,

import androidx.appcompat.app.AppCompatActivity;

import android.Manifest;
import android.os.Build;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        requestPermissions();
    }

    private void requestPermissions() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            requestPermissions(new String[]{Manifest.permission.READ_PHONE_STATE,
                    Manifest.permission.WRITE_EXTERNAL_STORAGE}, 100);
        }
    }
}

        Están involucradas un total de 4 clases (el número de líneas de código se estima dentro de 50):

        Compile y ejecute la aplicación escrita, conceda permisos, vea la interfaz y vea la barra de notificaciones, como se muestra en la figura:

         Paso 8

        Presione en la plataforma Jiguang Push, haga clic en "Enviar vista previa" y luego en "Confirmar envío":

        Paso 9

        Verifique el push en la aplicación móvil (haga clic en el push y desaparecerá, y no hay otra acción, porque no lo configuré en la clase Receptor), como se muestra en la figura:

3. Referencias

        1. Acceso rápido a Android - Documentación de Jiguang

        2. Uso simple de Jiguang Push

Cuatro Conclusión

        Una última palabra. Para las bibliotecas de terceros, le sugiero que consulte directamente la documentación oficial para su configuración y uso.Leer los blogs de otras personas puede hacer que encuentre muchas trampas, incluido mi blog. Los blogs técnicos suelen ser sensibles al tiempo. No se enoje si pisa un pozo. En comparación con las bibliotecas de terceros, se ha actualizado iterativamente. Es normal que los blogs en los últimos años no sean aplicables. Solo lea más documentos oficiales, ¡recuerde!