diff options
author | Jeff Davidson <jpd@google.com> | 2014-04-22 23:25:53 -0700 |
---|---|---|
committer | Jeff Davidson <jpd@google.com> | 2014-04-25 14:34:55 -0700 |
commit | ec4b1ce0b67a2386c270551146ce7932003525a7 (patch) | |
tree | 0f751a2c700f4192e58f3489ca04ad2b1881c0d1 /java/README.txt | |
parent | f1019531a6d587b247d08acb71dc5fe1f0577aa4 (diff) | |
download | protobuf-ec4b1ce0b67a2386c270551146ce7932003525a7.tar.gz protobuf-ec4b1ce0b67a2386c270551146ce7932003525a7.tar.bz2 protobuf-ec4b1ce0b67a2386c270551146ce7932003525a7.zip |
Support generation of Parcelable nano messages.
This CL adds the "parcelable_messages" option. When enabled, all
generated message classes will conform to the Android Parcelable
contract. This is achieved by introducing a new parent class for
generated classes which implements the required functionality.
Since the store_unknown_fields option also makes use of a superclass,
ExtendableMessageNano, we have two versions of the new Parcelable
superclass: one extending MessageNano, and one extending
ExtendableMessageNano. These classes are otherwise identical.
As these classes depend on Android framework jars, they are not
included in the host .jar build of the nanoproto library.
Finally, add a test suite for running tests of Android-specific
functionality, as this cannot be done on a desktop JVM.
Change-Id: Icc2a257f03317e947f7078dbb9857c3286857497
Diffstat (limited to 'java/README.txt')
-rw-r--r-- | java/README.txt | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/java/README.txt b/java/README.txt index f922c4be..c6933138 100644 --- a/java/README.txt +++ b/java/README.txt @@ -476,6 +476,7 @@ java_nano_generate_has -> true or false [DEPRECATED] optional_field_style -> default or accessors enum_style -> c or java ignore_services -> true or false +parcelable_messages -> true or false java_package: java_outer_classname: @@ -588,6 +589,9 @@ ignore_services={true,false} (default: false) it will generate a compilation error. If this flag is set to true, services will be silently ignored, instead. +parcelable_messages={true,false} (default: false) + Android-specific option to generate Parcelable messages. + To use nano protobufs within the Android repo: @@ -638,8 +642,13 @@ Please run the following steps to test: - cd ../../.. - . build/envsetup.sh - lunch 1 -- "make -j12 aprotoc libprotobuf-java-2.3.0-nano aprotoc-test-nano-params" and +- "make -j12 aprotoc libprotobuf-java-2.3.0-nano aprotoc-test-nano-params NanoAndroidTest" and check for build errors. +- Plug in an Android device or start an emulator. +- adb install -r out/target/product/generic/data/app/NanoAndroidTest.apk +- Run: + "adb shell am instrument -w com.google.protobuf.nano.test/android.test.InstrumentationTestRunner" + and verify all tests pass. - repo sync -c -j256 - "make -j12" and check for build errors |