2013-09-22 00:08:40 +02:00
|
|
|
F-Droid Client
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
Client for [F-Droid](https://fdroid.org), the Free Software repository system
|
|
|
|
|
for Android.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Building from source
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
The only required tools are the Android SDK and Apache Ant.
|
|
|
|
|
|
2013-09-22 00:49:00 +02:00
|
|
|
```
|
2013-09-23 20:32:55 +02:00
|
|
|
git submodule update --init
|
2014-01-09 12:35:38 +01:00
|
|
|
./ant-prepare.sh # This runs 'android update' on the libs and the main project
|
2013-09-22 00:49:00 +02:00
|
|
|
ant clean release
|
|
|
|
|
```
|
2013-09-22 00:08:40 +02:00
|
|
|
|
2014-01-19 20:50:11 +01:00
|
|
|
The project itself supports Gradle, but some of the libraries it uses don't.
|
|
|
|
|
Hence it is currently not possible to build F-Droid with Gradle in a clean way
|
|
|
|
|
without manual interaction.
|
|
|
|
|
|
2014-03-16 14:03:46 +01:00
|
|
|
Building as part of a ROM
|
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
|
|
Add the following lines to your repo manifest
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
<remote name="fdroid" fetch="https://git.gitorious.org/f-droid" />
|
|
|
|
|
<remote name="github" fetch="https://github.com/" />
|
|
|
|
|
|
|
|
|
|
<project path="packages/apps/fdroidclient" name="fdroidclient.git" remote="fdroid" revision="master" />
|
|
|
|
|
|
|
|
|
|
<project path="packages/apps/fdroidclient/extern/UniversalImageLoader" name="nostra13/Android-Universal-Image-Loader" remote="github" revision="master" />
|
|
|
|
|
|
|
|
|
|
<project path="packages/apps/fdroidclient/extern/MemorizingTrustManager" name="ge0rg/MemorizingTrustManager" remote="github" revision="master" />
|
|
|
|
|
|
|
|
|
|
<!-- should be binaryparadox/AndroidPinning once pullrequest #2 is closed -->
|
|
|
|
|
<project path="packages/apps/fdroidclient/extern/AndroidPinning" name="rtreffer/AndroidPinning" remote="github" revision="master" />
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Adding F-Droid is then just a matter of adding "F-Droid" to your PRODUCT_PACKAGES.
|
2013-09-22 00:08:40 +02:00
|
|
|
|
|
|
|
|
Direct download
|
|
|
|
|
---------------
|
|
|
|
|
|
2013-09-22 00:43:31 +02:00
|
|
|
You can [download the application](https://f-droid.org/FDroid.apk) directly
|
2014-02-10 09:37:03 +01:00
|
|
|
from our site or [browse it in the
|
|
|
|
|
repo](https://f-droid.org/app/org.fdroid.fdroid).
|
2013-09-22 00:08:40 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Contributing
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
You are welcome to submit Merge Requests via the Gitorious web interface. You
|
|
|
|
|
can also follow our [Issue tracker](https://f-droid.org/repository/issues/)
|
|
|
|
|
and our [Forums](https://f-droid.org/forums/).
|
|
|
|
|
|
|
|
|
|
|
2013-10-25 21:11:40 +02:00
|
|
|
Translating
|
|
|
|
|
-----------
|
|
|
|
|
|
2014-02-10 09:37:03 +01:00
|
|
|
The `res/values-*` dirs are kept up to date automatically via [MediaWiki's
|
|
|
|
|
Translate Extension](http://www.mediawiki.org/wiki/Extension:Translate). See
|
|
|
|
|
[our translation page](https://f-droid.org/wiki/page/Special:Translate) if you
|
|
|
|
|
would like to contribute.
|
2013-10-25 21:11:40 +02:00
|
|
|
|
2014-02-13 23:28:31 -05:00
|
|
|
|
|
|
|
|
Running the test suite
|
|
|
|
|
----------------------
|
|
|
|
|
|
|
|
|
|
FDroid client includes a embedded Android Test Project for running tests. It
|
|
|
|
|
is in the `test/` subfolder. To run the tests from the command line, do:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
git submodule update --init
|
|
|
|
|
./ant-prepare.sh # This runs 'android update' on the libs and the main project
|
|
|
|
|
ant clean emma debug install test
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can also run the tests in Eclipse. Here's how:
|
|
|
|
|
|
|
|
|
|
1. Choose *File* -> *Import* -> *Android* -> *Existing Android Code Into Workspace* for the `fdroidclient/` directory.
|
|
|
|
|
2. Choose *File* -> *Import* -> *Android* -> *Existing Android Code Into Workspace* for the `fdroidclient/test/` directory
|
|
|
|
|
3. If **fdroid-test** has errors, right-click on it, select *Properties*, the
|
|
|
|
|
*Java Build Path*, then click on the *Projects* tab.
|
|
|
|
|
4. Click on the *Add...* button and select `fdroidclient/`
|
|
|
|
|
5. Right-click on the **fdroid-test** project, then *Run As...* -> *Android JUnit Test*
|
|
|
|
|
|
|
|
|
|
|
2013-09-22 00:08:40 +02:00
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
This program is Free Software: You can use, study share and improve it at your
|
|
|
|
|
will. Specifically you can redistribute and/or modify it under the terms of the
|
|
|
|
|
[GNU General Public License](https://www.gnu.org/licenses/gpl.html) as
|
|
|
|
|
published by the Free Software Foundation, either version 3 of the License, or
|
|
|
|
|
(at your option) any later version.
|
