/WordPress-Android

WordPress for Android
  1. Java 93.8%
  2. JavaScript 4.4%
  3. PLpgSQL 0.7%
  4. HTML 0.5%
  5. CSS 0.3%
  6. Python 0.2%
  7. Other 0.1%
Java JavaScript PLpgSQL HTML CSS Python Other
Find file
Latest commit 2206ba5 Feb 27, 2017 @maxme maxme Merge branch 'develop' of https://github.com/wordpress-mobile/WordPre… 
…ss-Android into develop
Permalink
Failed to load latest commit information.
.github Removing Needs Review: Aug 3, 2016
WordPress alpha-37 / 355 version bump Feb 27, 2017
cq-configs/checkstyle checkstyle: allow package and protected members Apr 11, 2014
gradle/wrapper Updating gradle wrapper Sep 22, 2016
keystore first BUCK integration Apr 13, 2015
libs Fix NPE in resizeImageAndWriteToStream() Feb 25, 2017
tools Add en-gb to the list of translated release notes Feb 14, 2017
.gitattributes move new editor logic to a fragment Feb 4, 2015
.gitignore Adds .bak to .gitignore Nov 8, 2016
.travis.yml Updating travis Feb 1, 2017
CODE-OF-CONDUCT.md Updated Code of Conduct with contact information Feb 10, 2017
CODESTYLE.md initial commit of CODESTYLE.md Jun 23, 2014
CONTRIBUTING.md Explains the reason behind not translating string arrays Aug 16, 2016
LICENSE.md Squashed 'libs/editor/' changes from aec6410..77cb2fb Jun 15, 2015
README.md Remove BUCK references in the README Sep 27, 2016
build.gradle disable preDex task on travis-ci builds Oct 8, 2014
gradle.properties-example Move gradle.properties to gradle.properties-example May 20, 2016
gradlew update to gradle 2.14.1 Aug 16, 2016
gradlew.bat update to gradle 2.14.1 Aug 16, 2016
settings.gradle Remove links to unused subprojects used during development May 3, 2016

README.md

WordPress for Android

Build Status

If you're just looking to install WordPress for Android, you can find it on Google Play. If you're a developer wanting to contribute, read on.

Build Instructions

You first need to generate the local.properties (replace YOUR_SDK_DIR with your actual android SDK directory) file and create the gradle.properties file:

$ echo "sdk.dir=YOUR_SDK_DIR" > local.properties
$ cp ./WordPress/gradle.properties-example ./WordPress/gradle.properties

Note: this is the default ./WordPress/gradle.properties file. If you want to use WordPress.com features (login to a WordPress.com account, access the Reader and Stats for example), you'll have to get a WordPress.com OAuth2 ID and secret. Please read the OAuth2 Authentication section.

You can now build, install and test the project:

$ ./gradlew assembleVanillaDebug # assemble the debug .apk
$ ./gradlew installVanillaDebug  # install the debug .apk if you have an
                                 # emulator or an Android device connected
$ ./gradlew cAT                  # assemble, install and run unit tests

You can use Android Studio by importing the project as a Gradle project.

Directory structure

|-- libs                    # dependencies used to build debug variants
|-- tools                   # script collection
`-- WordPress
    |-- build.gradle        # main build script
    |-- gradle.properties   # properties imported by the build script
    `-- src                 # android specific Java code
        |-- androidTest     # test assets, resources and code
        |-- main            #
        |   |-- assets      # main project assets
        |   |-- java        # main project java code
        |   `-- res         # main project resources
        |-- vanilla         # vanilla variant specific manifest
        `-- wasabi          # wasabi variant specific resources and manifest

OAuth2 Authentication

In order to use WordPress.com functions you will need a client ID and a client secret key. These details will be used to authenticate your application and verify that the API calls being made are valid. You can create an application or view details for your existing applications with our WordPress.com applications manager.

When creating your application, you should select "Native client" for the application type. The applications manager currently requires a "redirect URL", but this isn't used for mobile apps. Just use "https://localhost".

Once you've created your application in the applications manager, you'll need to edit the ./WordPress/gradle.properties file and change the WP.OAUTH.APP.ID and WP.OAUTH.APP.SECRET fields. Then you can compile and run the app on a device or an emulator and try to login with a WordPress.com account.

Read more about OAuth2 and the WordPress.com REST endpoint.

How we work

You can read more about Code Style Guidelines we adopted, and how we're organizing branches in our repository in the Contribution Guide.

Need help to build or hack?

Say hello on our Slack channel: #mobile.

FAQ

  • Q: I can't build/test/package the project because of a PermGen space error.
  • A: Create a build.properties file in the project root directory with the following: org.gradle.jvmargs=-XX:MaxPermSize=1024m.

License

WordPress for Android is an Open Source project covered by the GNU General Public License version 2. Note: code in the libs/ directory comes from external libraries, which might be covered by a different license compatible with the GPLv2.