.buckconfig

@@ -1,12 +1,14 @@
 
 [android]
-  target = Google Inc.:Google APIs:23
+  target = android-29
 
 [download]
   max_number_of_retries = 3
 
 [maven_repositories]
   central = https://repo1.maven.org/maven2
+  google = https://maven.google.com/
+  jcenter = https://jcenter.bintray.com/
 
 [alias]
   rntester = //RNTester/android/app:app

.circleci/DockerTests.md

@@ -0,0 +1,81 @@
+# Docker Test Environment
+
+This is a high-level overview of the test configuration using Docker. 
+It explains how to run the tests locally.
+
+## Docker Installation
+
+It is required to have Docker running on your machine in order to build and run the tests in the Dockerfiles.
+See <https://docs.docker.com/engine/installation/> for more information on how to install.
+
+## Convenience Scripts
+
+We have added a number of default run scripts to the `package.json` file to simplify building and running your tests.
+
+### Configuring Docker Images
+
+The following two scripts need to be run first before you can move on to testing:
+
+- `yarn run docker-setup-android`: Pulls down the React Native Community Android image that serves as a base image when building the actual test image.
+
+- `yarn run docker-build-android`: Builds a test image with the latest dependencies and React Native library code, including a compiled Android test app.
+
+### Running Tests
+
+Once the test image has been built, it can be used to run our Android tests.
+
+- `yarn run test-android-run-unit` runs the unit tests, as defined in `scripts/run-android-docker-unit-tests.sh`.
+- `yarn run test-android-run-e2e` runs the end to end tests, as defined in `scripts/run-ci-e2e-tests.sh`.
+- `yarn run test-android-run-instrumentation` runs the instrumentation tests, as defined in `scripts/run-android-docker-instrumentation-tests.sh`.
+
+#### Instrumentation Tests
+
+The instrumentation test script accepts the following flags in order to customize the execution of the tests:
+
+`--filter` - A regex that filters which instrumentation tests will be run. (Defaults to .*)
+
+`--package` - Name of the java package containing the instrumentation tests (Defaults to com.facebook.react.tests)
+
+`--path` - Path to the directory containing the instrumentation tests. (Defaults to ./ReactAndroid/src/androidTest/java/com/facebook/react/tests)
+
+`--retries` - Number of times to retry a failed test before declaring a failure (Defaults to 2)
+
+For example, if locally you only wanted to run the InitialPropsTestCase, you could do the following:
+`yarn run test-android-run-instrumentation -- --filter="InitialPropsTestCase"`
+
+## Detailed Android Setup
+
+There are two Dockerfiles for use with the Android codebase.
+The base image used to build `reactnativecommunity/react-native-android` is located in the https://github.com/react-native-community/docker-android GitHub repository. 
+It contains all the necessary prerequisites required to run the React Android tests. 
+It is separated out into a separate Dockerfile because these are dependencies that rarely change and also because it is quite a beastly image since it contains all the Android dependencies for running Android and the emulators (~9GB).
+
+The good news is you should rarely have to build or pull down the base image!
+All iterative code updates happen as part of the `Dockerfile.android` image build.
+
+Lets break it down...
+
+First, you'll need to pull the base image. 
+You can use `docker pull` to grab the latest version of the `reactnativecommunity/react-native-android` base image.
+This is what you get when you run `yarn run docker-setup-android`.
+
+This will take quite some time depending on your connection and you need to ensure you have ~10GB of free disk space.
+
+Once you have downloaded the base image, the test image can be built using `docker build -t reactnativeci/android -f ./.circleci/Dockerfiles/Dockerfile.android .`. This is what `yarn run docker-build-android` does. Note that the `-t` flag is how you tell Docker what to name this image locally. You can then use `docker run -t reactnativeci/android` to run this image.
+
+Now that you've built the test image, you can run unit tests using what you've learned so far:
+
+```bash
+docker run --cap-add=SYS_ADMIN -it reactnativeci/android bash .circleci/Dockerfiles/scripts/run-android-docker-unit-tests.sh
+```
+
+> Note: `--cap-add=SYS_ADMIN` flag is required for the `.circleci/Dockerfiles/scripts/run-android-docker-unit-tests.sh` and `.circleci/Dockerfiles/scripts/run-android-docker-instrumentation-tests.sh` in order to allow the remounting of `/dev/shm` as writeable so the `buck` build system may write temporary output to that location.
+
+Every time you make any modifications to the codebase, including changes to the test scripts inside `.circleci/Dockerfiles/scripts`, you should re-run the `docker build ...` command in order for your updates to be included in your local docker test image.
+
+For rapid iteration, it's useful to keep in mind that Docker can pass along arbitrary commands to an image.
+For example, you can alternatively use Gradle in this manner:
+
+```bash
+docker run --cap-add=SYS_ADMIN -it reactnativeci/android ./gradlew RNTester:android:app:assembleRelease
+```

.circleci/Dockerfiles/Dockerfile.android

@@ -0,0 +1,52 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+#
+# This image builds upon the React Native Community Android image:
+# https://github.com/react-native-community/docker-android
+#
+# The base image is expected to remain relatively stable, and only
+# needs to be updated when major dependencies such as the Android
+# SDK or NDK are updated.
+#
+# In this Android Test image, we download the latest dependencies
+# and build a Android application that can be used to run the
+# tests specified in the scripts/ directory.
+#
+FROM reactnativecommunity/react-native-android:2019-10-18
+
+LABEL Description="React Native Android Test Image"
+LABEL maintainer="Héctor Ramos <hector@fb.com>"
+
+# set default environment variables
+ENV GRADLE_OPTS="-Dorg.gradle.daemon=false -Dorg.gradle.jvmargs=\"-Xmx512m -XX:+HeapDumpOnOutOfMemoryError\""
+ENV JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF8"
+
+ADD .buckconfig /app/.buckconfig
+ADD .buckjavaargs /app/.buckjavaargs
+ADD tools /app/tools
+ADD ReactAndroid /app/ReactAndroid
+ADD ReactCommon /app/ReactCommon
+ADD React /app/React
+ADD keystores /app/keystores
+
+WORKDIR /app
+
+RUN buck fetch ReactAndroid/src/test/java/com/facebook/react/modules
+RUN buck fetch ReactAndroid/src/main/java/com/facebook/react
+RUN buck fetch ReactAndroid/src/main/java/com/facebook/react/shell
+RUN buck fetch ReactAndroid/src/test/...
+RUN buck fetch ReactAndroid/src/androidTest/...
+
+RUN buck build ReactAndroid/src/main/java/com/facebook/react
+RUN buck build ReactAndroid/src/main/java/com/facebook/react/shell
+
+ADD . /app
+
+RUN yarn
+
+RUN ./gradlew :ReactAndroid:downloadBoost :ReactAndroid:downloadDoubleConversion :ReactAndroid:downloadFolly :ReactAndroid:downloadGlog
+
+RUN ./gradlew :ReactAndroid:packageReactNdkLibsForBuck -Pjobs=1
+

ContainerShip/scripts/run-android-ci-instrumentation-tests.js → .circleci/Dockerfiles/scripts/run-android-ci-instrumentation-tests.js

@@ -1,10 +1,8 @@
 /**
- * Copyright (c) 2015-present, Facebook, Inc.
- * All rights reserved.
+ * Copyright (c) Facebook, Inc. and its affiliates.
  *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  */
 
 'use strict';
@@ -20,7 +18,6 @@
  * --package - com.facebook.react.tests
  * --retries [num] - how many times to retry possible flaky commands: npm install and running tests, default 1
  */
-/*eslint-disable no-undef */
 
 const argv = require('yargs').argv;
 const async = require('async');
@@ -31,7 +28,7 @@ const path = require('path');
 const colors = {
     GREEN: '\x1b[32m',
     RED: '\x1b[31m',
-    RESET: '\x1b[0m'
+    RESET: '\x1b[0m',
 };
 
 const test_opts = {
@@ -41,10 +38,10 @@ const test_opts = {
     PATH: argv.path || './ReactAndroid/src/androidTest/java/com/facebook/react/tests',
     RETRIES: parseInt(argv.retries || 2, 10),
 
-    TEST_TIMEOUT: parseInt(argv['test-timeout'] || 1000 * 60 * 10),
+    TEST_TIMEOUT: parseInt(argv['test-timeout'] || 1000 * 60 * 10, 10),
 
     OFFSET: argv.offset,
-    COUNT: argv.count
+    COUNT: argv.count,
 };
 
 let max_test_class_length = Number.NEGATIVE_INFINITY;
@@ -71,7 +68,6 @@ testClasses = testClasses.map((clazz) => {
 
 // only process subset of the tests at corresponding offset and count if args provided
 if (test_opts.COUNT != null && test_opts.OFFSET != null) {
-    const testCount = testClasses.length;
     const start = test_opts.COUNT * test_opts.OFFSET;
     const end = start + test_opts.COUNT;
 
@@ -84,14 +80,14 @@ if (test_opts.COUNT != null && test_opts.OFFSET != null) {
     }
 }
 
-return async.mapSeries(testClasses, (clazz, callback) => {
+async.mapSeries(testClasses, (clazz, callback) => {
     if (clazz.length > max_test_class_length) {
         max_test_class_length = clazz.length;
     }
 
     return async.retry(test_opts.RETRIES, (retryCb) => {
-        const test_process = child_process.spawn('./ContainerShip/scripts/run-instrumentation-tests-via-adb-shell.sh', [test_opts.PACKAGE, clazz], {
-            stdio: 'inherit'
+        const test_process = child_process.spawn('./.circleci/Dockerfiles/scripts/run-instrumentation-tests-via-adb-shell.sh', [test_opts.PACKAGE, clazz], {
+            stdio: 'inherit',
         });
 
         const timeout = setTimeout(() => {
@@ -115,7 +111,7 @@ return async.mapSeries(testClasses, (clazz, callback) => {
     }, (err) => {
         return callback(null, {
             name: clazz,
-            status: err ? 'failure' : 'success'
+            status: err ? 'failure' : 'success',
         });
     });
 }, (err, results) => {

.circleci/Dockerfiles/scripts/run-android-docker-instrumentation-tests.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# for buck gen
+mount -o remount,exec /dev/shm
+
+AVD_UUID=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 8 | head -n 1)
+
+# create virtual device
+echo no | android create avd -n "$AVD_UUID" -f -t android-19 --abi default/armeabi-v7a
+
+# emulator setup
+emulator64-arm -avd $AVD_UUID -no-skin -no-audio -no-window -no-boot-anim &
+bootanim=""
+until [[ "$bootanim" =~ "stopped" ]]; do
+    sleep 5
+    bootanim=$(adb -e shell getprop init.svc.bootanim 2>&1)
+    echo "boot animation status=$bootanim"
+done
+
+set -x
+
+# solve issue with max user watches limit
+echo 65536 | tee -a /proc/sys/fs/inotify/max_user_watches
+watchman shutdown-server
+
+# integration tests
+# build JS bundle for instrumentation tests
+node cli.js bundle --platform android --dev true --entry-file ReactAndroid/src/androidTest/js/TestBundle.js --bundle-output ReactAndroid/src/androidTest/assets/AndroidTestBundle.js
+
+# build test APK
+# shellcheck disable=SC1091
+source ./scripts/android-setup.sh && NO_BUCKD=1 retry3 buck install ReactAndroid/src/androidTest/buck-runner:instrumentation-tests --config build.threads=1
+
+# run installed apk with tests
+node ./.circleci/Dockerfiles/scripts/run-android-ci-instrumentation-tests.js "$*"
+exit $?

.circleci/Dockerfiles/scripts/run-android-docker-unit-tests.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# set default environment variables
+UNIT_TESTS_BUILD_THREADS="${UNIT_TESTS_BUILD_THREADS:-1}"
+
+# for buck gen
+mount -o remount,exec /dev/shm
+
+set -x
+
+# run unit tests
+buck test ReactAndroid/src/test/... --config build.threads="$UNIT_TESTS_BUILD_THREADS"