Android/Services: Difference between revisions

→‎Getting started: I should use the preview button.
(Created page with "The Android Background Services module is a collection of related functionality that supports Mozilla's work on Android. Its remit is services, adapters, uploaders, downloaders, ...")
 
(→‎Getting started: I should use the preview button.)
 
(6 intermediate revisions by 3 users not shown)
Line 6: Line 6:


Other work (e.g., the updater) lives in mozilla-central, typically as part of the mobile/ tree.
Other work (e.g., the updater) lives in mozilla-central, typically as part of the mobile/ tree.
== People ==
; Owner : Richard Newman
; Peers : Chris Peterson, Nick Alexander, Chenxia Liu, James Willcox
See also: [https://wiki.mozilla.org/Modules/All#Android_Background_Services Module owners] for Android Background Services.
Look for us in #androidsync, #mobile on IRC.
== Bugs ==
See the following:
*  Android Background Services: [https://bugzilla.mozilla.org/buglist.cgi?product=Android%20Background%20Services&component=Android%20Sync&resolution=---&list_id=6438806 Android Sync] bugs
* Android Background Services: [https://bugzilla.mozilla.org/buglist.cgi?product=Android%20Background%20Services&component=Build%20%26%20Test&resolution=---&list_id=6438807 Build and Test] bugs
* [https://bugzilla.mozilla.org/buglist.cgi?product=Android%20Background%20Services&component=Firefox%20Health%20Report%20Service&resolution=---&list_id=6438816 Firefox Health Report] Service bugs for Android
* [https://bugzilla.mozilla.org/buglist.cgi?product=Android%20Background%20Services&component=Product%20Announcements&resolution=---&list_id=6438824 Product announcements] bugs
* [https://bugzilla.mozilla.org/describecomponents.cgi?product=Services%20for%20Android Services for Android] (pending)
* [https://bugzilla.mozilla.org/describecomponents.cgi?product=Mozilla%20Services Mozilla Services]
* [https://bugzilla.mozilla.org/describecomponents.cgi?product=Firefox%20for%20Android Firefox for Android]
== Getting started ==
There are two tiers of working with the Android Services codebase:
* Standalone, which involves working in Git, probably in Eclipse, using Maven for dependencies, and running JUnit tests. Tests that involve running against a Fennec instance can use a repackaged binary.
* Integrated, which means you deploy services code into a <code>mozilla-central</code> tree. You need this if you're landing code in the shipping product, or need to run tests using [[Auto-tools/Projects/Robocop|Robocop]].
== Getting started ==
[https://github.com/mozilla-services/android-sync/blob/develop/README.rst Read this].
But in short:
=== Getting the repo ===
<pre>
git clone https://github.com/mozilla-services/android-sync
git checkout develop
</pre>
=== Setting up the preprocessor ===
<pre>
python preprocess.py
</pre>
If you plan to use a prepackaged build, you don't need to do anything further.
If you plan to use a custom build, edit the resulting <code>preprocess.ini</code> to change the package name (e.g., to <code>org.mozilla.gecko.fennec_username</code>). Then run the preprocessor again.
=== Running tests locally ===
<pre>
mvn test
</pre>
Confirmed users
975

edits