Import workflow-kotlin-compose repo into the compose/ directory.

.github/CODEOWNERS

@@ -1,3 +1,7 @@
 # These owners will be the default owners for everything in
 # the repo, unless a later match takes precedence.
 * @square/mobile-foundation-android zach-klippenstein
+
+# Any files under the compose directory in the repo root should
+# be reviewed by UI Systems as well.
+/compose/ @square/mobile-foundation-android @square/ui-systems-android @wardellbagby

.github/workflows/compose-kotlin.yml

@@ -0,0 +1,143 @@
+name: Compose CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths:
+    - 'compose/**'
+    - '.github/workflows/compose-kotlin.yml'
+
+env:
+  GRADLE_HOME: ${{ github.workspace }}/gradle-home
+
+defaults:
+  run:
+    working-directory: compose
+
+jobs:
+  assemble:
+    name: Assemble
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      # These setup steps should be common across all jobs in this workflow.
+      - uses: actions/checkout@v2
+      - uses: gradle/wrapper-validation-action@v1
+      - name: set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+
+      ## Caching
+      - name: Cache gradle dependencies
+        uses: actions/cache@v1
+        with:
+          path: ${{ env.GRADLE_HOME }}/caches
+          # Include the SHA in the hash so this step always adds a cache entry. If we didn't use the SHA, the artifacts
+          # would only get cached once for each build config hash.
+          # Don't use ${{ runner.os }} in the key so we don't re-assemble for UI tests.
+          key: gradle-${{ hashFiles('**/gradle/wrapper/gradle-wrapper.properties') }}-${{ hashFiles('**/*.gradle*') }}-${{ hashFiles('**/buildSrc/**') }}-${{ github.sha }}
+          # The first time a SHA is assembled, we still want to load dependencies from the cache.
+          # Note that none of jobs dependent on this one need restore keys, since they'll always have an exact hit.
+          restore-keys: |
+            gradle-${{ hashFiles('**/gradle/wrapper/gradle-wrapper.properties') }}-${{ hashFiles('**/*.gradle*') }}-${{ hashFiles('**/buildSrc/**') }}-
+
+      # We want to keep the dependencies from the cache, but clear out the build cache which contains the actual
+      # compiled artifacts from this project. This ensures we don't run into any issues with stale cache entries,
+      # and that the resulting cache we upload for the other jobs won't waste any space on stale binaries.
+      # A simpler approach would be simply to delete the build-cache before uploading the cache archive, however
+      # if we did that in this job it would defeat the purpose of sharing that directory with dependent jobs,
+      # and there's no way to modify the cache after the job that created it finishes.
+      - name: Clean gradle build cache to assemble fresh
+        run: |
+          ls -lhrt "$GRADLE_HOME/caches" || true
+          rm -rf "$GRADLE_HOME/caches/build-cache-1"
+          ls -lhrt "$GRADLE_HOME/caches" || true
+
+      ## Actual task
+      - name: Assemble with gradle
+        run: ./gradlew assemble --build-cache --no-daemon --stacktrace --gradle-user-home "$GRADLE_HOME"
+
+  # Runs all check tasks in parallel.
+  check:
+    name: Check
+    needs: assemble
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      # Run all checks, even if some fail.
+      fail-fast: false
+      matrix:
+        gradle-task:
+          # Unit tests
+          - test
+          # Binary compatibility
+          - apiCheck
+          - lint
+          - ktlintCheck
+          - detekt
+    steps:
+      - uses: actions/checkout@v2
+      - name: set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+
+      ## Caching
+      - name: Cache build artifacts
+        uses: actions/cache@v1
+        with:
+          path: ${{ env.GRADLE_HOME }}/caches
+          # Don't set restore-keys so cache is always only valid for the current build config.
+          # Also don't use ${{ runner.os }} in the key so we don't re-assemble for UI tests.
+          key: gradle-${{ hashFiles('**/gradle/wrapper/gradle-wrapper.properties') }}-${{ hashFiles('**/*.gradle*') }}-${{ hashFiles('**/buildSrc/**') }}-${{ github.sha }}
+
+      ## Actual task
+      - name: Check with Gradle
+        run: ./gradlew ${{ matrix.gradle-task }} --build-cache --no-daemon --stacktrace --gradle-user-home "$GRADLE_HOME"
+
+  instrumentation-tests:
+    name: Instrumentation tests
+    needs: assemble
+    runs-on: macos-latest
+    timeout-minutes: 30
+    strategy:
+      # Allow tests to continue on other devices if they fail on one device.
+      fail-fast: false
+      matrix:
+        api-level:
+          # See https://github.com/square/workflow-kotlin-compose/issues/54
+          # - 21
+          - 24
+          - 29
+    steps:
+      - uses: actions/checkout@v2
+      - name: set up JDK 1.8
+        uses: actions/setup-java@v1
+        with:
+          java-version: 1.8
+
+      ## Caching
+      - name: Cache build artifacts
+        uses: actions/cache@v1
+        with:
+          path: ${{ env.GRADLE_HOME }}/caches
+          # Don't set restore-keys so cache is always only valid for the current build config.
+          # Also don't use ${{ runner.os }} in the key so we don't re-assemble for UI tests.
+          key: gradle-${{ hashFiles('**/gradle/wrapper/gradle-wrapper.properties') }}-${{ hashFiles('**/*.gradle*') }}-${{ hashFiles('**/buildSrc/**') }}-${{ github.sha }}
+
+      ## Actual task
+      - name: Instrumentation Tests
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: ${{ matrix.api-level }}
+          arch: x86_64
+          # This task doesn't use the run default specified at the top of the file.
+          working-directory: compose
+          script: ./gradlew connectedCheck --build-cache --no-daemon --stacktrace --gradle-user-home "$GRADLE_HOME"
+      - name: Upload results
+        uses: actions/upload-artifact@v2
+        with:
+          name: instrumentation-test-results
+          path: ./**/build/reports/androidTests/connected/**

.github/workflows/kotlin.yml

@@ -8,6 +8,8 @@ on:
     paths-ignore:
       # Don't build the entire app when just changing tutorials, which have their own workflow.
       - 'samples/tutorial/**'
+      # The compose integration has its own workflow.
+      - 'compose/**'
 
 jobs:
   dokka:

compose/.buildscript/android-sample-app.gradle

@@ -0,0 +1,9 @@
+apply from: rootProject.file('.buildscript/configure-android-defaults.gradle')
+
+dependencies {
+  implementation(project(":compose-tooling"))
+  implementation(Deps.get("androidx.appcompat"))
+  implementation(Deps.get("timber"))
+  implementation(Deps.get("workflow.core"))
+  implementation(Deps.get("workflow.runtime"))
+}

compose/.buildscript/android-ui-tests.gradle

@@ -0,0 +1,16 @@
+android {
+  defaultConfig {
+    testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+  }
+  testOptions {
+    animationsDisabled = true
+  }
+}
+
+dependencies {
+  androidTestImplementation Deps.get("compose.test")
+  androidTestImplementation Deps.get("test.androidx.espresso.core")
+  androidTestImplementation Deps.get("test.androidx.junitExt")
+  androidTestImplementation Deps.get("test.kotlin")
+  androidTestImplementation Deps.get("test.truth")
+}

compose/.buildscript/binary-validation.gradle

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2020 Square Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * We use JetBrain's Kotlin Binary Compatibility Validator to track changes to our public binary
+ * APIs.
+ * When making a change that results in a public ABI change, the apiCheck task will fail. When this
+ * happens, run ./gradlew apiDump to generate updated *.api files, and add those to your commit.
+ * See https://github.com/Kotlin/binary-compatibility-validator
+ */
+
+apply plugin: 'binary-compatibility-validator'
+
+apiValidation {
+  // Ignore all sample projects, since they're not part of our API.
+  // Only leaf project name is valid configuration, and every project must be individually ignored.
+  // See https://github.com/Kotlin/binary-compatibility-validator/issues/3
+  ignoredProjects += project('samples').name
+}

compose/.buildscript/configure-android-defaults.gradle

@@ -0,0 +1,29 @@
+android {
+  compileSdkVersion Versions.targetSdk
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  defaultConfig {
+    minSdkVersion 21
+    targetSdkVersion Versions.targetSdk
+    versionCode 1
+    versionName "1.0"
+  }
+
+  buildFeatures.viewBinding = true
+
+  // See https://github.com/Kotlin/kotlinx.coroutines/issues/1064#issuecomment-479412940
+  packagingOptions {
+    exclude 'META-INF/*.kotlin_module'
+    exclude 'META-INF/AL2.0'
+    exclude 'META-INF/LGPL2.1'
+  }
+
+  lintOptions {
+    // Workaround lint bug.
+    disable "InvalidFragmentVersionForActivityResult"
+  }
+}

compose/.buildscript/configure-compose.gradle

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2020 Square Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+android {
+  buildFeatures {
+    compose true
+  }
+  composeOptions {
+    kotlinCompilerVersion Versions.kotlin
+    kotlinCompilerExtensionVersion Versions.compose
+  }
+}

compose/.buildscript/configure-maven-publish.gradle

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2019 Square Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+apply plugin: 'com.vanniktech.maven.publish'
+
+group = GROUP
+version = VERSION_NAME

compose/.editorconfig

@@ -0,0 +1,3 @@
+[*.kt]
+indent_size = 2
+continuation_indent_size=4

compose/.gitignore

@@ -0,0 +1,36 @@
+# macOS
+.DS_Store
+
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+# Gradle
+out/
+.gradle/
+build/
+local.properties
+
+# Intellij
+*.iml
+.idea/