Create API jar like Android does with stubbed methods?

Question

I'm looking to distribute a custom API and know the classes will be available at run time. I would like my public and protected methods / classes to be included in a jar I can distribute but I don't want any other source code and I would like to throw an exception if that jars code is actually executed.

This is the exact behaviour the Android framework jar has when you attempt to execute the jar directly.

My question is how to I create the same jar from my source without manually going through and creating each stubbed method. I would like this to scale as my API grows.

Answer 1

I believe you can use for that purpose the mkstubs tool: https://github.com/android/platform_development/tree/master/tools/mkstubs

As @CommonsWare mentioned stubs in AOSP are generated by javadoc DroidDoc script, read here: How are .java files in android_stubs_current_intermediates directory generated?