Using MessagePack with Android

(Hopefully) FINAL UPDATE

msgpack : 0.6.8 works on Android without any problems

msgpack-rpc : 0.7.0 works on Android with one caveat.

Specifically, you need to add the following to onCreate for API Level 8 (Android 2.2.1), and possibly lower:

java.lang.System.setProperty("java.net.preferIPv4Stack", "true");
java.lang.System.setProperty("java.net.preferIPv6Addresses", "false");

due to this bug.

If you want to see a simple example, here’s a pair of projects set up for this purpose:


Previous Versions

UPDATE: as of 0.6.7 msgpack should be compatible with Android (there is a small dependency exclusion issue). Check the text below for msgpack-rpc (which also might be adapted in the future).

NOTE: If you’re also using msgpack-rpc, you need to do the following steps:

  1. Download the msgpack-rpc source from git://github.com/msgpack/msgpack-rpc.git (specifically, the “java” folder).
  2. Change the main msgpack artifact version to the one you’ve built.
  3. In org.msgpack.rpc.loop.netty.NettyEventLoop, change the NioClientSocketChannelFactory to OioClientSocketChannelFactory(getWorkerExecutor()).
  4. Build the MessagePack-RPC in the same way as in the case of the main MessagePack JAR (see Step 11 above).

The NettyEventLoop replacement is due to this issue:
http://markmail.org/message/ypa3nrr64kzsyfsa .

Important: I’ve only tested synchronous communication. Asynchronous might not work.


And here’s the reason for msgpack not working with Android prior to 0.6.7:

The reason for the error is that MessagePack uses several java.beans classes that are not included in the Android SDK. You’re probably using the MessagePackBeans annotation.

This is a similar problem to the one described here, for which the general solution is outlined here. Unfortunately, in our case it requires a rebuild of msgpack. Here’s what I did (you can almost certainly skip Steps 5 and 8, but I haven’t tried it that way) :

  1. Download the MessagePack source from https://github.com/msgpack/msgpack-java.git.
  2. Import the MessagePack source as a project in your IDE.
  3. Download the Apache Harmony source for the relevant packages from http://svn.apache.org/repos/asf/harmony/enhanced/java/trunk/classlib/modules/beans/src/main/java .
  4. Copy these packages into your MessagePack project’s src/main/java folder:
    • java.beans
    • java.beans.beancontext
    • org.apache.harmony.beans
    • org.apache.harmony.beans.internal.nls
  5. In your MessagePack project, remove the following classes:
    • PropertyChangeListener
    • IndexedPropertyChangeEvent
    • PropertyChangeEvent
    • PropertyChangeListenerProxy
    • PropertyChangeSupport
  6. Rename the java.beans packages to something different, e.g. custom.beans .
  7. Change all java.beans references to the renamed ID, so again e.g. custom.beans. This applies especially to BeansFieldEntryReader (this class is the reason for the original error).
  8. Change the custom.beans references for the five classes you removed in Step 5 back to java.beans.
  9. In the org.apache.harmony.beans.internal.nls.Messages class, comment out the method setLocale, and remove the imports associated with it.
  10. Remove all classes that still have errors, except Encoder. In that class, comment out all references to the classes you’ve removed. You should now have an error-free project.
  11. Build the MessagePack JAR:
    • If you’re using Maven, change the version in the pom.xml to something unique, run Maven build with the install goal, then add the dependency in your Android project with that version.
    • If you’re not using Maven, you have to run the jar goal for Ant with the included build.xml. Replace the msgpack JAR in your Android project with this one.
  12. If you’re publishing your app, remember to include the relevant legal notice for Apache Harmony. It’s an Apache License, just like MessagePack.

That should do it. Using your example code, and my own data class, I was successfully able to pack and unpack data.

The entire renaming ritual is due to the fact that the DEX compiler complains about java.* package naming.

Leave a Comment