JPush (极光推送) For Xamarin.Android

官方教程上讲的是 GCM (Google Cloud Messaging) , 不过 GFW 是 GCM 过不去的坎.

极光推送 JPush 是国内的一个不错的替代方案.

JPush 提供的 API 易于理解, 使用也很简单, 但是要使用于 Xamarin 还是要费些周章: 要转制成 Binding Library.

JPush 提供了一篇转制的示例:

http://smilehyh.blog.163.com/blog/static/123343886201362110857402/

 

按照过程走一遍:

1, 下载 JPush SDK

http://docs.jpush.io/resources/

 

2, 新建一个 BindingLibrary

 

3, 将 SDK内的 JPush.xxx.jar 放到 Jars 目录下, 将 SDK 内的 arm64-v8a, armeabi, armeabi-v7a 放到 libs 目录下.

 

4, 指定jar 文件为 EmbeddedJar, xxx.so 为 EmbeddedNativeLibrary

具体 EmbeddedNativeLibrary 和 EmbeddedJar 各代表什么意思, 请参考:

https://developer.xamarin.com/guides/android/advanced_topics/java_integration_overview/binding-a-java-library/

 

5,编译, 并在 Xamarin.Android工程中引用该项目, 修改 Android 项目属性, 指定 Package Name. 注意: 首字母要小写, 否则运会报错

 

6, 按照文档 http://docs.jpush.io/guideline/android_guide/  中的说明, 修改 Properties/AndroidManifest.xml,

这一步可用编码来实现, 后面会讲到.

 

7,  在 MainActivity 的 OnCreate 方法里加入 (红色部分):

 1         protected override void OnCreate(Bundle bundle) {
 2             base.OnCreate(bundle);
 3 
 4             global::Xamarin.Forms.Forms.Init(this, bundle);
 5 
 6             FormsAppCompatActivity.ToolbarResource = Resource.Layout.toolbar;
 7             FormsAppCompatActivity.TabLayoutResource = Resource.Layout.tabs;
 8 
 9             LoadApplication(new App(IoC.Get<SimpleContainer>()));
10 
11             JPushInterface.SetDebugMode(true);
12             JPushInterface.Init(this);
13         }

 

8, 如果你是用 Visual Studio Emulator For Android 模拟器进行调试, 不出意外, 你会在输出中看到以下信息:

[JPushGlobal] Get sdk version fail![获取sdk版本失败!]
W/System.err( 2063): java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[DexPathList[[zip file "/data/app/notification.Droid-1/base.apk"],nativeLibraryDirectories=[/data/app/notification.Droid-1/lib/x86, /vendor/lib, /system/lib]]] couldn't find "libjpush205.so"
...

很显然, VS Emulator For Android 是基于 x86 的. 要解决这个问题, 请下载 JPush SDK 的 x86 版本 , 重复 2 ~ 4 的步骤, 新建另外一个 Binding Library, 并添加引用到 Xamarin.Android 项目.

 

9, 编译,运行, 确认模拟器或设备连接到网络 , 如果配置没有错误, 你会看到以下信息:

 

10, 发送测试:

 

 

 

 

 

---------------------------------分隔线-------------------------------

该部份只是一个偿试，不建议使用， 直接修改 Manifest 添加配置就挺好的。

 

第一眼看到极光的 AndroidManifest.xml 配置, 我头大了, 这都什么和什么啊 (对 Android 还是不太了解)!

android.permission.RECEIVE_USER_PRESENT 这个 Permission 在 VS 的 Manifest 选项卡中居然没有!

有好几处需要替换为 Package Name

<category android:name="您应用的包名"/>
<permission android:name="您应用的包名.permission.JPUSH_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="您应用的包名.permission.JPUSH_MESSAGE" />

这里的 "包名" 即 上面的 第5步 里指定的 Package name.

 

 

Xamarin.Android 提供了很多 Attribute , 编译的时候, 会跟据这些 Attribute 对 Manifest 文件自动进行修改, 比如:

    [Activity(Label = "Notification", Theme = "@style/MyTheme", Icon = "@drawable/icon", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation)]
    public class MainActivity : FormsAppCompatActivity {

这个 ActivityAttribute 在最终的 Manifest 文件 (xxx\obj\Debug\android\AndroidManifest.xml) 中输出这样:

1     <activity android:configChanges="orientation|screenSize" android:icon="@drawable/icon" android:label="Notification" android:theme="@style/MyTheme" android:name="md5d2dc98e5b163ec8eaa18490df03b0a9d.MainActivity">
2       <intent-filter>
3         <action android:name="android.intent.action.MAIN" />
4         <category android:name="android.intent.category.LAUNCHER" />
5       </intent-filter>
6     </activity>

 

 

1     [Service]
2     [IntentFilter(new string[] { "Xamarin.BallService" })]
3     public class BallService : Service, View.IOnTouchListener, View.IOnClickListener { 

这个 ServiceAttribute 和 IntentFilterAttribute 最终会输出成这样:

1     <service android:name="md5e15bd1e8131f68eb8f9fc22d8285f415.BallService">
2       <intent-filter>
3         <action android:name="Xamarin.BallService" />
4       </intent-filter>
5     </service>

 

 

在 Binding Library 项目下, 有个Additions 目录, 它的作用 就是为了在转制的时候 加入一些自定义方法 或 是自定义类, 或是对 Java 的类进行扩展:

Additions allow you to add arbitrary C# to the generated classes before they are compiled. This can be helpful for providing convenience methods or adding pure C# classes.

如果是对 Java 类进行扩展, 需要使用 partical

 

跟据这个牛B的特性, 我在 Additions 目录下加了这几个类:

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android.Service {
14     [BroadcastReceiver(Name = "cn.jpush.android.service.AlarmReceiver")]
15     public partial class AlarmReceiver {
16 
17     }
18 }

AlarmReceiver

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android.Service {
14 
15     [Service(Name = "cn.jpush.android.service.DaemonService", Enabled = true, Exported = true)]
16     [IntentFilter(
17         new string[] { "cn.jpush.android.intent.DaemonService" },
18         Categories = new string[] { Defines.APP_ID }
19         )
20     ]
21     public partial class DaemonService {
22     }
23 }

DaemonService

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android.Service {
14 
15     
16     [Service(Name = "cn.jpush.android.service.DownloadService", Enabled = true, Exported = false)]
17     public partial class DownloadService {
18 
19     }
20 }

DownloadService

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 using Android.Content.PM;
13 
14 namespace CN.Jpush.Android.UI {
15 
16     [Activity(Name = "cn.jpush.android.ui.PushActivity",
17         ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.KeyboardHidden,
18         Exported = false)]
19     [IntentFilter(new string[] { 
20         "cn.jpush.android.ui.PushActivity"
21     }, Categories = new string[]{
22         "android.intent.category.DEFAULT",
23         Defines.APP_ID
24     })]
25     public partial class PushActivity {
26 
27         public void TTT() {
28         }
29 
30     }
31 }

PushActivity

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android.Service {
14 
15     [BroadcastReceiver(Name = "cn.jpush.android.service.PushReceiver", Enabled = true)]
16     [IntentFilter(new string[]{
17         "cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY"
18     },
19     Categories = new string[] { Defines.APP_ID },
20     Priority = 1000)]
21     [IntentFilter(new string[] { 
22         "android.intent.action.USER_PRESENT" ,
23         "android.net.conn.CONNECTIVITY_CHANGE"
24     })]
25     [IntentFilter(new string[] { 
26         "android.intent.action.PACKAGE_ADDED",
27         "android.intent.action.PACKAGE_REMOVED"
28     }, DataScheme = "package")]
29     public partial class PushReceiver {
30     }
31 }

PushReceiver

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android.Service {
14 
15     [Service(Name = "cn.jpush.android.service.PushService", Enabled = true, Exported = false)]
16     [IntentFilter(new string[] { 
17         "cn.jpush.android.intent.REGISTER",
18         "cn.jpush.android.intent.REPORT",
19         "cn.jpush.android.intent.PushService",
20         "cn.jpush.android.intent.PUSH_TIME"
21     })]
22     public partial class PushService {
23 
24     }
25 }

PushService

 

以及:

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 
 6 using Android.App;
 7 using Android.Content;
 8 using Android.OS;
 9 using Android.Runtime;
10 using Android.Views;
11 using Android.Widget;
12 
13 namespace CN.Jpush.Android {
14     static class Defines {
15 
16         public const string APP_ID = "notification.Droid";
17     }
18 }

 

这个 APP_ID 为 Android 项目的 Package name , 在 DaemonService , PushReceiver 和 PushActivity 中, 做为 IntentFilterAttribute 的 Category 出现.

而且不可缺少, 否则推送会失败....

这一点很蛋疼... 如果这样的话, 这个 Binding Library 就是不可复用的了!

查了一下， 都是说 AndroidManifest.xml 不可动态修改,  当前也没有找到如何动态注册 Receiver / Activity / Service 的方法。

 

然后在 Android项目下面添加一个 Application.cs 继承自 Android.App.Application:

 1 [assembly: Permission(Name = Notification.Droid.Application.JPUSH_MESSAGE_PERMISSION, ProtectionLevel = Protection.Signature)]
 2 [assembly: UsesPermission(Name = Notification.Droid.Application.JPUSH_MESSAGE_PERMISSION)]
 3 [assembly: UsesPermission(Name = Android.Manifest.Permission.Internet)]
 4 [assembly: UsesPermission(Name = Android.Manifest.Permission.WakeLock)]
 5 [assembly: UsesPermission(Name = Android.Manifest.Permission.Vibrate)]
 6 [assembly: UsesPermission(Name = Android.Manifest.Permission.ReadPhoneState)]
 7 [assembly: UsesPermission(Name = Android.Manifest.Permission.WriteExternalStorage)]
 8 [assembly: UsesPermission(Name = Android.Manifest.Permission.ReadExternalStorage)]
 9 [assembly: UsesPermission(Name = Android.Manifest.Permission.MountUnmountFilesystems)]
10 [assembly: UsesPermission(Name = Android.Manifest.Permission.AccessNetworkState)]
11 [assembly: UsesPermission(Name = "android.permission.RECEIVE_USER_PRESENT")]
12 [assembly: UsesPermission(Name = Android.Manifest.Permission.WriteSettings)]
13 namespace Notification.Droid {
14 
15     [Application]
16     [MetaData("JPUSH_CHANNEL", Value = "developer-default")]
17     [MetaData("JPUSH_APPKEY", Value = "你的JPush APPKEY")]
18     public class Application : Android.App.Application {
19         //notification.Droid 即 Android 项目的 Package name
20         public const string JPUSH_MESSAGE_PERMISSION = "notification.Droid.permission.JPUSH_MESSAGE";
21 
22 
23         private SimpleContainer container;
24 
25         public Application(IntPtr javaReference, JniHandleOwnership transfer)
26             : base(javaReference, transfer) {
27         }

 

 

做完这一步, 你可以把上面第6步中, 添加到 Proierties/AndroidManifest.xml 中的配置全删了.

编译, xxx\obj\Debug\android\AndroidManifest.xml 中就会自动添加刚刚被你删除的配置了.

只是, 少了一个:

<service
            android:name="cn.jpush.android.service.DownloadService"
            android:enabled="true"
            android:exported="false" >
        </service>

 

用反编译工具查看转制成的 dll , 在 CN.Jpush.Android.Service 下, 根本就没有 DownloadService 这个类.

 

这是为啥呢? 在仔细的看一下 Binding Library 的编译输出, 发现有如下问题:

BINDINGSGENERATOR : warning BG8102: Class CN.Jpush.Android.Service.DownloadService has unknown base type android.app.IntentService.

 

未知的基类: android.app.IntentService , 导致 DownloadService 没有转制成功. 具体是为什么, 不了解, 搜了一下:

One of the classes internal to the Android project had methods marked as public, so android.app.IntentService was trying to leak out. 

http://forums.xamarin.com/discussion/9118/binding-generator-class-has-unknown-base-type-android-app-intentservice

 

解决方法也很简单: 用 Mono 的 IndentService 代替 android.app.intentService.
在 binding Library 项目下的 Transforms/Metadata.xml 中添加：

<attr path="/api/package[@name='cn.jpush.android.service']/class[@name='DownloadService' and @extends='android.app.IntentService']" name="extends">mono.android.app.IntentService</attr>

 

Metadata.xml 的具体用法请参见:

https://developer.xamarin.com/guides/android/advanced_topics/java_integration_overview/binding-a-java-library/java-bindings-metadata/

 

现在编译 Binding Library , 用反编译工具查看最终的 dll ,这个 DownloadService 就出现了.

然后编译 Android 项目, 那个 cn.jpush.android.service.DownService 也成功的出现在 AndroidManifest.xml 中了!

 

-------------------分隔线--------------------------

最后,  深入的集成 JPush, 在 Android 项目下添加类: Receiver

 1     [BroadcastReceiver(Enabled = true)]
 2     [IntentFilter(new string[] { 
 3         "cn.jpush.android.intent.REGISTRATION", 
 4         "cn.jpush.android.intent.UNREGISTRATION" ,
 5         "cn.jpush.android.intent.MESSAGE_RECEIVED",
 6         "cn.jpush.android.intent.NOTIFICATION_RECEIVED",
 7         "cn.jpush.android.intent.NOTIFICATION_OPENED", 
 8         "cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK",
 9         "cn.jpush.android.intent.CONNECTION"
10     }, Categories = new string[] { "notification.Droid" })]
11     public class Receiver : PushReceiver {
12 
13         public async override void OnReceive(Context ctx, Intent intent) {
14             base.OnReceive(ctx, intent);
15 
16             var action = intent.Action;
17             System.Diagnostics.Debug.WriteLine(action);
18 
19             var bundle = intent.Extras;
20             await ReceiverHandler.Handle(intent.Action, bundle);
21         }
22     }

 

Categories 中的 notification.Droid 还是 Package name

ReceiverHandler 是自定义的处理器,  

具体可参考:

http://docs.jpush.io/client/android_api/

 

--------------------------------------

OK, 完

源码: https://github.com/gruan01/Xamarin-Example/tree/master/Notification