I think we can mostly cover this by saying anything that's marked as "public" or "protected" is part of the public API. If we don't want it to be public, we should use package private.
On Wed, May 27, 2015 at 11:21 PM, Joe Bowser <bows...@gmail.com> wrote: > The bigger issue is the question of what is a public API. Android used > public docs to delineate between public and private APIs and I think we > should do the same, mostly because I want to draw a line between what we > can and can't support and not have everything in third-party tests break > because of a single contributor's opinion. > > This also means that when we do deprecate something, we write why. Of > course, we're tight on resources so if anyone wants to take that on, it > would be great. It's been on our to-do list for years and has never > happened. > > On Wed, May 27, 2015, 8:05 PM Andrew Grieve <agri...@chromium.org> wrote: > > > 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 > > > > > > > > > > > > > > > > > > > >
