Mobile/Fennec/Android/Eclipse: Difference between revisions

no edit summary
(Created page with "There is support for building Fennec using Eclipse in the tree. '''Building Fennec with Eclipse requires a custom Eclipse plugin'''. The preliminary Eclipse support landed i...")
 
No edit summary
Line 34: Line 34:
In Eclipse, go to ''File > Import...'' and select ''General > Existing Projects into Workspace''. Enter the path printed by <code>mach build-backend</code>.  You should see many projects, including one named ''Fennec''.  We want that one, and all its dependencies; at the moment, that means
In Eclipse, go to ''File > Import...'' and select ''General > Existing Projects into Workspace''. Enter the path printed by <code>mach build-backend</code>.  You should see many projects, including one named ''Fennec''.  We want that one, and all its dependencies; at the moment, that means


* Fennec
* ''Fennec''
* FennecOmnijar
* ''FennecOmnijar''
* FennecResources
* ''FennecResources''
* FennecResourcesBranding
* ''FennecResourcesBranding''
* FennecResourcesGenerated
* ''FennecResourcesGenerated''


== Test your Eclipse configuration ==
== Test your Eclipse configuration ==
Line 56: Line 56:
Your first step is to go to ''Eclipse > Preferences... > Android > Build'' and set the ''Build output'' setting to ''Normal''.  That will show logging from the custom plugin and from the Eclipse Android integration that can help.
Your first step is to go to ''Eclipse > Preferences... > Android > Build'' and set the ''Build output'' setting to ''Normal''.  That will show logging from the custom plugin and from the Eclipse Android integration that can help.


Your second step is to try refreshing all projects (Right click > ''Refresh'') and then doing a clean build (''Project > Clean build ...'').
Your second step is to try refreshing all projects (Right click projects > ''Refresh'') and then doing a clean build (''Project > Clean build ...'').


* I clobbered and now my Eclipse projects are gone!
* I clobbered and now my Eclipse projects are gone!
Line 63: Line 63:


   mach build-backend -b=AndroidEclipse
   mach build-backend -b=AndroidEclipse
= The custom Eclipse plugin =
== What the plugin does ==
The plugin is conceptually simple: as the first step of the Eclipse build for each project, it executes a single shell command (if necessary).  Indeed, it replaces a custom ANT build invocation that did exactly the same work.  Some of the advantages of the plugin are
* error markers in the Eclipse ''Problems'' pane
* build output in the Eclipse ''Android Console''
* faster builds
* it is less likely to cause the build to loop forever.
== Source code ==
The source code for the plugin (and the related Eclipse feature and update site) is hosted at
https://github.com/ncalexan/fennec-eclipse.  Pull requests are always welcome!


= Additional resources =
= Additional resources =


There is a [http://www.ncalexander.net/blog/2014/06/24/better-fennec-builds-with-an-eclipse-plugin/ screencast getting started].  There is also a [http://www.ncalexander.net/blog/2014/03/24/eclipse-mini-tutorials/ series of video mini-tutorials].
There is a [http://www.ncalexander.net/blog/2014/06/24/better-fennec-builds-with-an-eclipse-plugin/ getting started screencast].  There is also a [http://www.ncalexander.net/blog/2014/03/24/eclipse-mini-tutorials/ series of video mini-tutorials].


There's a blog post discussing [http://www.ncalexander.net/blog/2014/07/08/how-the-android-eclipse-integration-works/ technical details of how the Eclipse build integration works].
There's a blog post discussing [http://www.ncalexander.net/blog/2014/07/08/how-the-android-eclipse-integration-works/ technical details of how the Eclipse build integration works].
Line 97: Line 81:


ckitching wrote a detailed, but now out-dated, [http://perplexedturnip.wordpress.com/2013/07/31/bludgeoning-intellij-idea-into-being-useful-for-mobile-firefox-development/ blog post explaining how to develop Fennec IntelliJ].  ckitching is working on supporting building with IntelliJ in the tree.
ckitching wrote a detailed, but now out-dated, [http://perplexedturnip.wordpress.com/2013/07/31/bludgeoning-intellij-idea-into-being-useful-for-mobile-firefox-development/ blog post explaining how to develop Fennec IntelliJ].  ckitching is working on supporting building with IntelliJ in the tree.
= The custom Eclipse plugin =
== What the plugin does ==
The plugin is conceptually simple: as the first step of the Eclipse build for each project, it executes a single shell command (if necessary).  Indeed, it replaces a custom ANT build invocation that did exactly the same work.  Some of the advantages of the plugin are
* error markers in the Eclipse ''Problems'' pane
* build output in the Eclipse ''Android Console''
* faster builds
* it is less likely to cause the build to loop forever.
== Source code ==
The source code for the plugin (and the related Eclipse feature and update site) is hosted at
https://github.com/ncalexan/fennec-eclipse.  Pull requests are always welcome!
Confirmed users
355

edits