WordPress-Android

# WordPress for Android #

If you're just looking to install WordPress for Android, you can find it on [Google Play](https://play.google.com/store/apps/details?id=org.wordpress.android&referrer=utm_source%3Dgithub%26utm_medium%3Dwebsite).
If you're a developer wanting to contribute, read on.

## Build Instructions ##

1. Make sure you've installed [Android Studio](https://developer.android.com/studio).
2. Install npm using [Node Version Manager](https://github.com/nvm-sh/nvm)(nvm), as described in step one from the [Block Editor Quickstart guide](https://developer.wordpress.org/block-editor/getting-started/devenv/#quickstart)
3. `cd WordPress-Android` to enter the working directory.
4. In Android Studio, open the project from the local repository. This will auto-generate `local.properties` with the SDK location.
5. Recommended: The CI uses JDK11 to build the app and run the tests. Some tests won't pass on the JDK embedded in Android Studio (JDK8). You might want to set JAVA_HOME and JDK location in Android Studio to JDK11.
6. Go to Tools → AVD Manager and create an emulated device.
7. Run.

Notes:

* To use WordPress.com features (signing in with a WordPress.com account, the Reader, Stats, etc.) you need your own WordPress.com OAuth2 client ID and secret. Please read the [WordPress.com Authentication](docs/wpcom-authentication.md) guide.
* While loading/building the app in Android Studio, ignore the prompt to update the Gradle plugin version, as that will probably introduce build errors. On the other hand, feel free to update if you are planning to work on ensuring the compatibility of the newer version.

## Build and Test ##

To build, install, and test the project from the command line:

    $ ./gradlew assembleWordPressDebug                        # assemble the debug .apk
    $ ./gradlew installWordPressDebug                         # install the debug .apk if you have an
                                                                     # emulator or an Android device connected
    $ ./gradlew :WordPress:testWordPressDebugUnitTest         # assemble, install and run unit tests
    $ ./gradlew :WordPress:connectedWordPressDebugAndroidTest # assemble, install and run Android tests

## Running the app ##

You can sign in with a self-hosted WordPress site or with a WordPress.com account.

To use your own site, choose "Enter your existing site address" on the app start up screen, then enter the URL of your site and your credentials. If you don't have a site, you can create a temporary test site for free at https://jurassic.ninja/.

To use a WordPress.com account, first configure your own OAuth2 credentials by following the [WordPress.com Authentication](docs/wpcom-authentication.md) guide, then choose "Log in or sign up with WordPress.com" on the app start up screen.

## Directory structure ##
    .
    ├── libs                    # dependencies used to build debug variants
    ├── tools                   # script collection
    ├── gradle.prop