I'm wary of creating any docs for the Java APIs, since I think they will inevitably get out of sync with the real code (it's hard enough getting code comments to match the code).
I think some beefed up Javadocs might be nice, but I think plugin developers should just read through Cordova's code to see how it works (there's not that much of it). I found learning how cordova-android works was vastly easier than learning how "Android development" works (intents, activities, resources, services, etc), so I'm not convinced that there's any low-hanging fruit here. On Wed, May 27, 2015 at 8:59 PM, Nikhil Khandelwal <nikhi...@microsoft.com> wrote: > Joe, Andrew, Ian, Michael: I'm hoping one of you can plug this > documentation gap since you are most knowledgeable about changes from > Cordova-android 3.7 to 4.0. > > Thanks, > Nikhil > > > -----Original Message----- > From: Joe Bowser [mailto:bows...@gmail.com] > Sent: Friday, May 15, 2015 4:23 PM > To: dev@cordova.apache.org > Subject: Re: [BUG] Fail to build Mobilespec with --thirdpartyplugins > (CB-9032) > > I agree. This is something that I believe that is in the tracker. The > real problem with this is that we have no idea what our public API looks > like for plugin developers, or any documentation as to what the best > practices for plugin developers are. As far as regular non-plugin devs are > concerned, we didn't actually have a breaking API change for > Cordova-Android 4.0.0 other than the whitelists, which we made into a > plugin. > > One of the things that we actually fixed/improved in Cordova-Android 4.0, > the third-party Java dependencies, has no documentation, and we're > basically directing people to Crosswalk as the way to do this. We should > really be adding the documentation, and if anyone wants to take that on, > that'd be awesome. > > On Fri, May 15, 2015 at 4:06 PM Nikhil Khandelwal <nikhi...@microsoft.com> > wrote: > > > Is there a list of cordova-android 4.0 APIs that have been removed? I > > think a migration guide from Androind 3.7.1 => Androind 4.0.0 would be > > super useful. > > > > Thanks, > > Nikhil > > > > > > -----Original Message----- > > From: Joe Bowser [mailto:bows...@gmail.com] > > Sent: Friday, May 15, 2015 7:02 AM > > To: dev@cordova.apache.org > > Subject: Re: [BUG] Fail to build Mobilespec with --thirdpartyplugins > > (CB-9032) > > > > Hey > > > > I just took a look at those, and those are all the methods we decided > > to remove when we changed the API for Cordova-Android 4.0. We have no > > plans on bringing those methods back, so I'm going to close the issue. > > I recommend filing issues with those repositories to get them to > > update their plugins to the current API. > > > > On Fri, May 15, 2015 at 1:37 AM Lin, Wanming <wanming....@intel.com> > > wrote: > > > > > Hello, > > > > > > It is failed to build Mobilespec with "--thirdpartyplugins" on > > > Cordova CLI > > > 5.0.0 and latest commit of cordova-mobile-spec. > > > I've filed a JIRA bug: > > > https://issues.apache.org/jira/browse/CB-9032, > > > could anyone help take a look? Many thanks in advance! > > > > > > Thanks, > > > Wanming > > > > > > -------------------------------------------------------------------- > > > - To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org > > > For additional commands, e-mail: dev-h...@cordova.apache.org > > > > > > > > >
