Android屏幕适配

AndroidStudio集成极光推送SDK

JPush极光推送（以下简称“极光sdk”）是免费专业第三方云推送服务平台,专注于安卓推送Android消息推送,ios推送通知,手机推送,app云推送服务。极光sdk在eclipse下是很好集成的，但在AS下集成需要做一些细节上的修改。本篇blog主要记录AS下集成极光sdk的具体步骤

下载极光sdk

极光推送官网
当zip下载完成后，你也可以在这里参考极光推送的官方文档进行集成，如果你用的是AndroidStudio的话，建议你参考此blog来集成极光sdk，少走弯路。

极光SDK集成步骤

1、解压缩 jpush-sdk_v1.x.y.zip 集成压缩包

2、建议复制lib下所有.jar或.so文件

3、复制res下文件到你当前项目的res目录下

4、集成 JPush Android SDK 的混淆

5、配置 AndroidManifest.xml（重要）

根据 SDK 压缩包里的 AndroidManifest.xml 样例文件，来配置应用程序项目的 AndroidManifest.xml 。

在这里提供一份AS下的一份简单的AndroidManifest.xml模板

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="你的包名称">
    <uses-sdk android:minSdkVersion="11" android:targetSdkVersion="17" />
    <!-- Required 自定义用来收发消息的相关权限 -->
    <!--{applicationId}需要在app，build.gradle的defaultConfig节点下配置applicationId "你的包名"，你也可以在这里直接写你的包名-->
    <permission  android:name="${applicationId}.permission.JPUSH_MESSAGE" android:protectionLevel="signature" />

    <!-- Required 一些系统要求的权限，如访问网络等-->
    <uses-permission android:name="${applicationId}.permission.JPUSH_MESSAGE" />
    <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />


    <!-- Optional for location -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <application  android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:name=".MyApplication" android:supportsRtl="true" android:theme="@style/AppTheme">
        <!--test的主界面-->
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>


        <!-- Required SDK核心功能-->
        <activity  android:name="cn.jpush.android.ui.PushActivity" android:configChanges="orientation|keyboardHidden" android:theme="@android:style/Theme.NoTitleBar" android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.ui.PushActivity" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="${applicationId}" />
            </intent-filter>
        </activity>

        <!-- Required SDK核心功能-->
        <service  android:name="cn.jpush.android.service.DownloadService" android:enabled="true" android:exported="false" >
        </service>

        <!-- Required SDK 核心功能-->
        <!-- option since 2.0.5 可配置PushService，DaemonService,PushReceiver,AlarmReceiver的android:process参数 将JPush相关组件设置为一个独立进程 -->
        <!-- 如：android:process=":remote" -->
        <service  android:name="cn.jpush.android.service.PushService" android:enabled="true" android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTER" />
                <action android:name="cn.jpush.android.intent.REPORT" />
                <action android:name="cn.jpush.android.intent.PushService" />
                <action android:name="cn.jpush.android.intent.PUSH_TIME" />

            </intent-filter>
        </service>

        <!-- Required SDK 核心功能 since 1.8.0 -->
        <service  android:name="cn.jpush.android.service.DaemonService" android:enabled="true" android:exported="true">
            <intent-filter >
                <action android:name="cn.jpush.android.intent.DaemonService" />
                <category android:name="${applicationId}"/>
            </intent-filter>
        </service>

        <!-- Required SDK核心功能-->
        <receiver  android:name="cn.jpush.android.service.PushReceiver" android:enabled="true" android:exported="false">
            <intent-filter android:priority="1000">
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" /> <!--Required 显示通知栏 -->
                <category android:name="${applicationId}" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.USER_PRESENT" />
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            </intent-filter>
            <!-- Optional -->
            <intent-filter>
                <action android:name="android.intent.action.PACKAGE_ADDED" />
                <action android:name="android.intent.action.PACKAGE_REMOVED" />
                <data android:scheme="package" />
            </intent-filter>
        </receiver>

        <!-- Required SDK核心功能-->
        <receiver android:name="cn.jpush.android.service.AlarmReceiver" />

        <!-- User defined. 用户自定义的广播接收器-->
        <receiver  android:name="你自己定义一个类继承BroadcastReceiver" android:enabled="true">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.REGISTRATION" /> <!--Required 用户注册SDK的intent-->
                <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" /> <!--Required 用户接收SDK消息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" /> <!--Required 用户接收SDK通知栏信息的intent-->
                <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" /> <!--Required 用户打开自定义通知栏的intent-->
                <action android:name="cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK" /> <!--Optional 用户接受Rich Push Javascript 回调函数的intent-->
                <action android:name="cn.jpush.android.intent.CONNECTION" /><!-- 接收网络变化 连接/断开 since 1.6.3 -->
                <category android:name="${applicationId}" />
            </intent-filter>
        </receiver>

        <!-- Required . Enable it you can get statistics data with channel -->
        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
        <meta-data android:name="JPUSH_APPKEY" android:value="你在极光申请的AppKey" /> <!-- </>值来自开发者平台取得的AppKey-->

    </application>

</manifest>

初始化SDK（需要在应用程序启动时调用一次该 API 即可，所以建议写在Application里面）

public class MyApplication extends Application {
@Override
        public void onCreate() {
            super.onCreate();
      //初始化极光推送sdk
    JPushInterface.setDebugMode(true);
    JPushInterface.init(this);
    }
}

测试确认

• 确认所需的权限都已经添加。如果必须的权限未添加，日志会提示错误。
• 确认 AppKey（在Portal上生成的）已经正确的写入 Androidmanifest.xml 。
• 确认在程序启动时候调用了init(context) 接口。
• 确认测试手机（或者模拟器）已成功连入网络 ＋ 客户端调用 init 后不久，如果一切正常，应有登录成功的日志信息。
• 启动应用程序，在 Portal 上向应用程序发送自定义消息或者通知栏提示。

你以为这样就结束了吗？然而并没有，当你run起来的时候log日志可能会提示你什么，比如初始化失败，比如加载动态.so库文件失败。

例如这样的错误：[JPushGlobal] JPush .so file do not match JPush .jar file in the project, Failed to init JPush。

造成这个错误的原因是Android Studio没有正确加载这个libjpushxxx.so文件。

最后一步（也就是AS上关键一步）

APP目录下找到 build.gradle 文件，打开它，并添加如下字段（必须加）

//在android下添加这个一个sourceSets.main
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }

然后当我们的APP正常运行了，你试着在JPush上推送消息看看能不能收到。

如果还有问题。请参考这里:极光社区，搜索你出现的error，应该很快能找到解决方案。

关于作者
- 个人主页：Hsia
- Email：[email protected]