MixPush 开源项目指南

1. 项目介绍

MixPush 是一个高效的 Android 混合推送 SDK，它支持快速集成多个厂商的推送服务，包括小米推送（XG Push）、Google 的 FCM 等。这个 SDK 提供了一个共享的系统推送通道，即使应用被杀死，依然能够接收到推送消息，以保证高达 90% 以上的推送到达率。通过 MixPush，开发者可以更方便地管理和优化其应用的通知推送策略。

2. 项目快速启动

安装依赖

在你的 build.gradle 文件中添加 MixPush SDK 的依赖：

dependencies {
    implementation 'com.joyrun:mixpush-sdk:latest.version'
}

请将 latest.version 替换为你找到的最新版本号。

初始化 SDK

在应用的 Application 类中初始化 MixPush SDK：

import com.joyrun.mixpush.MixPushManager;

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化 MixPush SDK
        MixPushManager.getInstance().init(this);
    }
}

注册接收器

创建一个继承自 BroadcastReceiver 的类用于接收推送消息：

public class PushReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        // 处理推送消息
        String message = intent.getStringExtra("message");
        // ...
    }
}

// 在 AndroidManifest.xml 中注册广播接收器
<receiver android:name=".PushReceiver">
    <intent-filter>
        <action android:name="com.joyrun.ACTION_NOTIFY"/>
    </intent-filter>
</receiver>

用户授权与推送设置

在需要请求推送权限的地方调用：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECEIVE_USER_PRESENT)
            != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.RECEIVE_USER_PRESENT}, 1);
}

然后根据需求配置推送设置：

MixPushManager.getInstance().setNotificationTitle("我的应用");
MixPushManager.getInstance().setNotificationIcon(R.drawable.app_icon);

3. 应用案例和最佳实践

• 为了提高用户体验，可以根据用户的使用场景和时间来定制推送的内容和频率。
• 对于重要的通知，可以使用自定义通知栏样式或者附加数据，以便在用户点击时执行特定操作。
• 在用户首次打开应用或完成特定事件后，可以发送欢迎推送，引导用户熟悉功能。
• 定期分析推送效果，调整推送策略以提高用户活跃度。

4. 典型生态项目

MixPush 可以很好地与其他开源项目配合，例如：

• cordova-plugin-mixPush：Cordova 平台上的 MixPush 插件，使混合应用也能利用 MixPush 功能。
• Android App Startup：Google 提供的应用启动优化库，有助于确保 MixPush SDK 的高效加载。

通过这些生态项目，MixPush 可以广泛应用于各种类型的应用中，提升推送效率和用户体验。