diff --git a/.github/ci-gradle.properties b/.github/ci-gradle.properties
new file mode 100644
index 000000000..c349fe239
--- /dev/null
+++ b/.github/ci-gradle.properties
@@ -0,0 +1,23 @@
+#
+# Copyright 2020 The Android Open Source Project
+#
+# 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.
+#
+
+org.gradle.daemon=false
+org.gradle.parallel=true
+org.gradle.jvmargs=-Xmx5120m
+org.gradle.workers.max=2
+
+kotlin.incremental=false
+kotlin.compiler.execution.strategy=in-process
\ No newline at end of file
diff --git a/.github/workflows/AccessibilityCodelab.yaml b/.github/workflows/AccessibilityCodelab.yaml
new file mode 100644
index 000000000..0c645e81e
--- /dev/null
+++ b/.github/workflows/AccessibilityCodelab.yaml
@@ -0,0 +1,61 @@
+name: AccessibilityCodelab
+
+on:
+ push:
+ branches:
+ - main
+ - end
+ paths:
+ - 'AccessibilityCodelab/**'
+ pull_request:
+ paths:
+ - 'AccessibilityCodelab/**'
+
+env:
+ SAMPLE_PATH: AccessibilityCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/AdvancedStateAndSideEffectsCodelab.yaml b/.github/workflows/AdvancedStateAndSideEffectsCodelab.yaml
new file mode 100644
index 000000000..dd0a9c3ae
--- /dev/null
+++ b/.github/workflows/AdvancedStateAndSideEffectsCodelab.yaml
@@ -0,0 +1,117 @@
+name: AdvancedStateAndSideEffectsCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'AdvancedStateAndSideEffectsCodelab/**'
+ pull_request:
+ paths:
+ - 'AdvancedStateAndSideEffectsCodelab/**'
+
+env:
+ SAMPLE_PATH: AdvancedStateAndSideEffectsCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
+
+ test:
+ needs: build
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+ strategy:
+ matrix:
+ api-level: [26, 29]
+
+ steps:
+ # https://github.blog/changelog/2023-02-23-hardware-accelerated-android-virtualization-on-actions-windows-and-linux-larger-hosted-runners
+ - name: Enable KVM group perms
+ run: |
+ echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+ sudo udevadm control --reload-rules
+ sudo udevadm trigger --name-match=kvm
+ ls /dev/kvm
+
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Run instrumentation tests
+ uses: reactivecircus/android-emulator-runner@v2
+ with:
+ api-level: ${{ matrix.api-level }}
+ target: google_apis
+ arch: x86
+ disable-animations: true
+ script: ./gradlew connectedCheck --stacktrace
+ working-directory: ${{ env.SAMPLE_PATH }}
+
+ - name: Upload test reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: test-reports-state-${{ matrix.api-level }}
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/AnimationCodelab.yaml b/.github/workflows/AnimationCodelab.yaml
new file mode 100644
index 000000000..15f729030
--- /dev/null
+++ b/.github/workflows/AnimationCodelab.yaml
@@ -0,0 +1,60 @@
+name: AnimationCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'AnimationCodelab/**'
+ pull_request:
+ paths:
+ - 'AnimationCodelab/**'
+
+env:
+ SAMPLE_PATH: AnimationCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/BasicLayoutsCodelab.yaml b/.github/workflows/BasicLayoutsCodelab.yaml
new file mode 100644
index 000000000..158806511
--- /dev/null
+++ b/.github/workflows/BasicLayoutsCodelab.yaml
@@ -0,0 +1,60 @@
+name: BasicLayoutsCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'BasicLayoutsCodelab/**'
+ pull_request:
+ paths:
+ - 'BasicLayoutsCodelab/**'
+
+env:
+ SAMPLE_PATH: BasicLayoutsCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
\ No newline at end of file
diff --git a/.github/workflows/BasicStateCodelab.yaml b/.github/workflows/BasicStateCodelab.yaml
new file mode 100644
index 000000000..dd70acae7
--- /dev/null
+++ b/.github/workflows/BasicStateCodelab.yaml
@@ -0,0 +1,60 @@
+name: BasicStateCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'BasicStateCodelab/**'
+ pull_request:
+ paths:
+ - 'BasicStateCodelab/**'
+
+env:
+ SAMPLE_PATH: BasicStateCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
\ No newline at end of file
diff --git a/.github/workflows/BasicsCodelab.yaml b/.github/workflows/BasicsCodelab.yaml
new file mode 100644
index 000000000..8b9ffdecc
--- /dev/null
+++ b/.github/workflows/BasicsCodelab.yaml
@@ -0,0 +1,60 @@
+name: BasicsCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'BasicsCodelab/**'
+ pull_request:
+ paths:
+ - 'BasicsCodelab/**'
+
+env:
+ SAMPLE_PATH: BasicsCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
\ No newline at end of file
diff --git a/.github/workflows/MigrationCodelab.yaml b/.github/workflows/MigrationCodelab.yaml
new file mode 100644
index 000000000..a47e8a8f4
--- /dev/null
+++ b/.github/workflows/MigrationCodelab.yaml
@@ -0,0 +1,108 @@
+name: MigrationCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'MigrationCodelab/**'
+ pull_request:
+ paths:
+ - 'MigrationCodelab/**'
+
+env:
+ SAMPLE_PATH: MigrationCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
+
+ test:
+ needs: build
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+ strategy:
+ matrix:
+ api-level: [26, 29]
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Run instrumentation tests
+ uses: reactivecircus/android-emulator-runner@v2
+ with:
+ api-level: ${{ matrix.api-level }}
+ arch: x86
+ disable-animations: true
+ script: ./gradlew connectedCheck --stacktrace
+ working-directory: ${{ env.SAMPLE_PATH }}
+
+ - name: Upload test reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: test-reports-migration-${{ matrix.api-level }}
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/NavigationCodelab.yaml b/.github/workflows/NavigationCodelab.yaml
new file mode 100644
index 000000000..f17d32c48
--- /dev/null
+++ b/.github/workflows/NavigationCodelab.yaml
@@ -0,0 +1,61 @@
+name: NavigationCodelab
+
+on:
+ push:
+ branches:
+ - main
+ - end
+ paths:
+ - 'NavigationCodelab/**'
+ pull_request:
+ paths:
+ - 'NavigationCodelab/**'
+
+env:
+ SAMPLE_PATH: NavigationCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/TestingCodelab.yaml b/.github/workflows/TestingCodelab.yaml
new file mode 100644
index 000000000..94ad8111a
--- /dev/null
+++ b/.github/workflows/TestingCodelab.yaml
@@ -0,0 +1,61 @@
+name: TestingCodelab
+
+on:
+ push:
+ branches:
+ - main
+ - end
+ paths:
+ - 'TestingCodelab/**'
+ pull_request:
+ paths:
+ - 'TestingCodelab/**'
+
+env:
+ SAMPLE_PATH: TestingCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
diff --git a/.github/workflows/ThemingCodelab.yaml b/.github/workflows/ThemingCodelab.yaml
new file mode 100644
index 000000000..55bbef1db
--- /dev/null
+++ b/.github/workflows/ThemingCodelab.yaml
@@ -0,0 +1,60 @@
+name: ThemingCodelab
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'ThemingCodelab/**'
+ pull_request:
+ paths:
+ - 'ThemingCodelab/**'
+
+env:
+ SAMPLE_PATH: ThemingCodelab
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ timeout-minutes: 30
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Copy CI gradle.properties
+ run: mkdir -p ~/.gradle ; cp .github/ci-gradle.properties ~/.gradle/gradle.properties
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v5
+ with:
+ distribution: 'zulu'
+ java-version: 17
+
+ - name: Generate cache key
+ run: ./scripts/checksum.sh $SAMPLE_PATH checksum.txt
+
+ - uses: actions/cache@v5
+ with:
+ path: |
+ ~/.gradle/caches/modules-*
+ ~/.gradle/caches/jars-*
+ ~/.gradle/caches/build-cache-*
+ key: gradle-${{ hashFiles('checksum.txt') }}
+
+ - name: Build project
+ working-directory: ${{ env.SAMPLE_PATH }}
+ run: ./gradlew assembleDebug lintDebug --stacktrace
+
+ - name: Upload build outputs (APKs)
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-outputs
+ path: ${{ env.SAMPLE_PATH }}/app/build/outputs
+
+ - name: Upload build reports
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: build-reports
+ path: ${{ env.SAMPLE_PATH }}/app/build/reports
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..d134aa5bf
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+*.iml
+.gradle
+/local
+/.idea/*
+.DS_Store
+build/
+/captures
+.externalNativeBuild
+local.properties
+.kotlin/
diff --git a/AccessibilityCodelab/.gitignore b/AccessibilityCodelab/.gitignore
new file mode 100644
index 000000000..4a708a497
--- /dev/null
+++ b/AccessibilityCodelab/.gitignore
@@ -0,0 +1,12 @@
+*.iml
+.gradle
+/local.properties
+/.idea/*
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
+/buildSrc/.gradle/*
+.kotlin/
diff --git a/AccessibilityCodelab/ASSETS_LICENSE b/AccessibilityCodelab/ASSETS_LICENSE
new file mode 100644
index 000000000..e7fc95866
--- /dev/null
+++ b/AccessibilityCodelab/ASSETS_LICENSE
@@ -0,0 +1,88 @@
+All font files are licensed under the SIL OPEN FONT LICENSE license. All other files are licensed under the Apache 2 license.
+
+
+SIL OPEN FONT LICENSE
+Version 1.1 - 26 February 2007
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting — in part or in whole — any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
\ No newline at end of file
diff --git a/AccessibilityCodelab/README.md b/AccessibilityCodelab/README.md
new file mode 100644
index 000000000..4ead5bee5
--- /dev/null
+++ b/AccessibilityCodelab/README.md
@@ -0,0 +1,22 @@
+# Accessibility in Jetpack Compose Codelab
+
+This folder contains the source code for
+the [Accessibility in Jetpack Compose Codelab](https://developer.android.com/codelabs/jetpack-compose-accessibility)
+
+## License
+
+```
+Copyright 2021 The Android Open Source Project
+
+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
+
+ https://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.
+```
diff --git a/AccessibilityCodelab/app/.gitignore b/AccessibilityCodelab/app/.gitignore
new file mode 100644
index 000000000..796b96d1c
--- /dev/null
+++ b/AccessibilityCodelab/app/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/AccessibilityCodelab/app/build.gradle b/AccessibilityCodelab/app/build.gradle
new file mode 100644
index 000000000..f24e9a5d9
--- /dev/null
+++ b/AccessibilityCodelab/app/build.gradle
@@ -0,0 +1,130 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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.
+ */
+
+plugins {
+ id 'com.android.application'
+ id 'org.jetbrains.kotlin.plugin.compose'
+}
+
+android {
+ compileSdkVersion 37
+ namespace 'com.example.jetnews'
+ defaultConfig {
+ applicationId 'com.example.jetnews'
+ minSdkVersion 23
+ targetSdkVersion 33
+ versionCode 1
+ versionName '1.0'
+ vectorDrawables.useSupportLibrary = true
+ }
+
+ signingConfigs {
+ // We use a bundled debug keystore, to allow debug builds from CI to be upgradable
+ debug {
+ storeFile rootProject.file('debug.keystore')
+ storePassword 'android'
+ keyAlias 'androiddebugkey'
+ keyPassword 'android'
+ }
+ }
+
+ buildTypes {
+ debug {
+ signingConfig signingConfigs.debug
+ }
+
+ release {
+ minifyEnabled true
+ proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+ }
+
+ }
+
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+
+ buildFeatures {
+ compose true
+ }
+
+ packagingOptions {
+ excludes += "/META-INF/AL2.0"
+ excludes += "/META-INF/LGPL2.1"
+ }
+}
+
+dependencies {
+ def composeBom = platform('androidx.compose:compose-bom:2026.06.00')
+ implementation(composeBom)
+ testImplementation(composeBom)
+ androidTestImplementation(composeBom)
+
+ implementation "androidx.compose.runtime:runtime"
+ implementation "androidx.compose.ui:ui"
+ implementation "androidx.compose.foundation:foundation-layout"
+ implementation "androidx.compose.material3:material3"
+ implementation "androidx.compose.material:material-icons-extended"
+ implementation "androidx.compose.foundation:foundation"
+ implementation "androidx.compose.animation:animation"
+ implementation "androidx.compose.ui:ui-tooling-preview"
+ implementation "androidx.compose.runtime:runtime-livedata"
+ debugImplementation "androidx.compose.ui:ui-tooling"
+ debugImplementation "androidx.compose.ui:ui-test-manifest"
+ testImplementation "androidx.compose.ui:ui-test-junit4"
+ androidTestImplementation "androidx.compose.ui:ui-test"
+ androidTestImplementation "androidx.compose.ui:ui-test-junit4"
+
+ def accompanist_version = '0.36.0'
+ implementation "com.google.accompanist:accompanist-swiperefresh:$accompanist_version"
+ implementation "com.google.accompanist:accompanist-systemuicontroller:$accompanist_version"
+
+ implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2"
+
+ implementation 'androidx.appcompat:appcompat:1.7.1'
+ implementation 'androidx.activity:activity-ktx:1.13.0'
+ implementation 'androidx.core:core-ktx:1.19.0'
+ implementation "androidx.activity:activity-compose:1.13.0"
+
+ implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.11.0"
+ implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:2.11.0"
+ implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.11.0"
+ implementation "androidx.lifecycle:lifecycle-viewmodel-compose:2.11.0"
+
+ implementation 'androidx.navigation:navigation-compose:2.9.8'
+
+ androidTestImplementation 'androidx.test:rules:1.7.0'
+ androidTestImplementation 'androidx.test:runner:1.7.0'
+
+ // TODO: Bump to latest after Espresso 3.5.0 goes stable
+ // (due to https://github.com/robolectric/robolectric/issues/6593)
+ testImplementation 'org.robolectric:robolectric:4.16.1'
+}
+
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+ kotlinOptions {
+ // Treat all Kotlin warnings as errors (disabled by default)
+ allWarningsAsErrors = project.hasProperty("warningsAsErrors") ? project.warningsAsErrors : false
+
+ freeCompilerArgs += '-opt-in=kotlin.RequiresOptIn'
+ // Enable experimental coroutines APIs, including Flow
+ freeCompilerArgs += '-opt-in=kotlin.Experimental'
+
+ // Set JVM target to 1.8
+ jvmTarget = "1.8"
+ }
+}
diff --git a/AccessibilityCodelab/app/proguard-rules.pro b/AccessibilityCodelab/app/proguard-rules.pro
new file mode 100644
index 000000000..4cb94585a
--- /dev/null
+++ b/AccessibilityCodelab/app/proguard-rules.pro
@@ -0,0 +1,24 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+-renamesourcefileattribute SourceFile
+
+# Repackage classes into the top-level.
+-repackageclasses
diff --git a/AccessibilityCodelab/app/src/main/AndroidManifest.xml b/AccessibilityCodelab/app/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..2ef4ce5c2
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/AndroidManifest.xml
@@ -0,0 +1,33 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/JetnewsApplication.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/JetnewsApplication.kt
new file mode 100644
index 000000000..086db2a61
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/JetnewsApplication.kt
@@ -0,0 +1,32 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews
+
+import android.app.Application
+import com.example.jetnews.data.AppContainer
+import com.example.jetnews.data.AppContainerImpl
+
+class JetnewsApplication : Application() {
+
+ // AppContainer instance used by the rest of classes to obtain dependencies
+ lateinit var container: AppContainer
+
+ override fun onCreate() {
+ super.onCreate()
+ container = AppContainerImpl(this)
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/AppContainerImpl.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/AppContainerImpl.kt
new file mode 100644
index 000000000..b60382cf1
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/AppContainerImpl.kt
@@ -0,0 +1,45 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.data
+
+import android.content.Context
+import com.example.jetnews.data.interests.InterestsRepository
+import com.example.jetnews.data.posts.PostsRepository
+
+/**
+ * Dependency Injection container at the application level.
+ */
+interface AppContainer {
+ val postsRepository: PostsRepository
+ val interestsRepository: InterestsRepository
+}
+
+/**
+ * Implementation for the Dependency Injection container at the application level.
+ *
+ * Variables are initialized lazily and the same instance is shared across the whole app.
+ */
+class AppContainerImpl(private val applicationContext: Context) : AppContainer {
+
+ override val postsRepository: PostsRepository by lazy {
+ PostsRepository()
+ }
+
+ override val interestsRepository: InterestsRepository by lazy {
+ InterestsRepository()
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/interests/InterestsRepository.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/interests/InterestsRepository.kt
new file mode 100644
index 000000000..c272cf28d
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/interests/InterestsRepository.kt
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.data.interests
+
+import com.example.jetnews.utils.addOrRemove
+import kotlinx.coroutines.ExperimentalCoroutinesApi
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.sync.Mutex
+import kotlinx.coroutines.sync.withLock
+
+typealias TopicsMap = Map>
+
+/**
+ * Implementation of InterestRepository that returns a hardcoded list of
+ * topics, people and publications synchronously.
+ */
+@OptIn(ExperimentalCoroutinesApi::class)
+class InterestsRepository {
+
+ /**
+ * Get relevant topics to the user.
+ */
+ val topics by lazy {
+ mapOf(
+ "Android" to listOf("Jetpack Compose", "Kotlin", "Jetpack"),
+ "Programming" to listOf("Kotlin", "Declarative UIs", "Java"),
+ "Technology" to listOf("Pixel", "Google")
+ )
+ }
+
+ // for now, keep the selections in memory
+ private val selectedTopics = MutableStateFlow(setOf())
+
+ // Used to make suspend functions that read and update state safe to call from any thread
+ private val mutex = Mutex()
+
+ /**
+ * Toggle between selected and unselected
+ */
+ suspend fun toggleTopicSelection(topic: TopicSelection) {
+ mutex.withLock {
+ val set = selectedTopics.value.toMutableSet()
+ set.addOrRemove(topic)
+ selectedTopics.value = set
+ }
+ }
+
+ /**
+ * Currently selected topics
+ */
+ fun observeTopicsSelected(): Flow> = selectedTopics
+}
+
+data class TopicSelection(val section: String, val topic: String)
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsData.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsData.kt
new file mode 100644
index 000000000..86e970f20
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsData.kt
@@ -0,0 +1,1027 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.data.posts.impl
+
+import com.example.jetnews.R
+import com.example.jetnews.model.Markup
+import com.example.jetnews.model.MarkupType
+import com.example.jetnews.model.Metadata
+import com.example.jetnews.model.Paragraph
+import com.example.jetnews.model.ParagraphType
+import com.example.jetnews.model.Post
+import com.example.jetnews.model.PostAuthor
+import com.example.jetnews.model.Publication
+
+/**
+ * Define hardcoded posts to avoid handling any non-ui operations.
+ */
+
+val pietro = PostAuthor("Pietro Maggi", "https://medium.com/@pmaggi")
+val manuel = PostAuthor("Manuel Vivo", "https://medium.com/@manuelvicnt")
+val florina = PostAuthor(
+ "Florina Muntenescu",
+ "https://medium.com/@florina.muntenescu"
+)
+val jose =
+ PostAuthor("Jose Alcérreca", "https://medium.com/@JoseAlcerreca")
+
+val publication = Publication(
+ "Android Developers",
+ "https://cdn-images-1.medium.com/max/258/1*u7oZc2_5mrkcFaxkXEyfYA@2x.png"
+)
+val paragraphsPost1 = listOf(
+ Paragraph(
+ ParagraphType.Text,
+ "Working to make our Android application more modular, I ended up with a sample that included a set of on-demand features grouped inside a folder:"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Pretty standard setup, all the on-demand modules, inside a “features” folder; clean."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "These modules are included in the settings.gradle file as:"
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "include ':app'\n" +
+ "include ':features:module1'\n" +
+ "include ':features:module2'\n" +
+ "include ':features:module3'\n" +
+ "include ':features:module4'"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "These setup works nicely with a single “minor” issue: an empty module named features in the Android view in Android Studio:"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "I can live with that, but I would much prefer to remove that empty module from my project!"
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "If you cannot remove it, just rename it!"
+ ),
+
+ Paragraph(
+ ParagraphType.Text,
+ "At I/O I was lucky enough to attend the “Android Studio: Tips and Tricks” talk where Ivan Gravilovic, from Google, shared some amazing tips. One of these was a possible solution for my problem: setting a custom path for my modules.",
+ listOf(
+ Markup(
+ MarkupType.Italic,
+ 41,
+ 72
+ )
+ )
+ ),
+
+ Paragraph(
+ ParagraphType.Text,
+ "In this particular case our settings.gradle becomes:",
+ listOf(Markup(MarkupType.Code, 28, 43))
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ """
+ include ':app'
+ include ':module1'
+ include ':module1'
+ include ':module1'
+ include ':module1'
+ """.trimIndent()
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ """
+ // Set a custom path for the four features modules.
+ // This avoid to have an empty "features" module in Android Studio.
+ project(":module1").projectDir=new File(rootDir, "features/module1")
+ project(":module2").projectDir=new File(rootDir, "features/module2")
+ project(":module3").projectDir=new File(rootDir, "features/module3")
+ project(":module4").projectDir=new File(rootDir, "features/module4")
+ """.trimIndent()
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "And the layout in Android Studio is now:"
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Conclusion"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "As the title says, this is really a small thing, but it helps keep my project in order and it shows how a small Gradle configuration can help keep your project tidy."
+ ),
+ Paragraph(
+ ParagraphType.Quote,
+ "You can find this update in the latest version of the on-demand modules codelab.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 54,
+ 79,
+ "https://codelabs.developers.google.com/codelabs/on-demand-dynamic-delivery/index.html"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Resources"
+ ),
+ Paragraph(
+ ParagraphType.Bullet,
+ "Android Studio: Tips and Tricks (Google I/O’19)",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 0,
+ 47,
+ "https://www.youtube.com/watch?v=ihF-PwDfRZ4&list=PLWz5rJ2EKKc9FfSQIRXEWyWpHD6TtwxMM&index=32&t=0s"
+ )
+ )
+ ),
+
+ Paragraph(
+ ParagraphType.Bullet,
+ "On Demand module codelab",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 0,
+ 24,
+ "https://codelabs.developers.google.com/codelabs/on-demand-dynamic-delivery/index.html"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Bullet,
+ "Patchwork Plaid — A modularization story",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 0,
+ 40,
+ "https://medium.com/androiddevelopers/a-patchwork-plaid-monolith-to-modularized-app-60235d9f212e"
+ )
+ )
+ )
+)
+
+val paragraphsPost2 = listOf(
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger is a popular Dependency Injection framework commonly used in Android. It provides fully static and compile-time dependencies addressing many of the development and performance issues that have reflection-based solutions.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 0,
+ 6,
+ "https://dagger.dev/"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "This month, a new tutorial was released to help you better understand how it works. This article focuses on using Dagger with Kotlin, including best practices to optimize your build time and gotchas you might encounter.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 14,
+ 26,
+ "https://dagger.dev/tutorial/"
+ ),
+ Markup(MarkupType.Bold, 114, 132),
+ Markup(MarkupType.Bold, 144, 159),
+ Markup(MarkupType.Bold, 191, 198)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger is implemented using Java’s annotations model and annotations in Kotlin are not always directly parallel with how equivalent Java code would be written. This post will highlight areas where they differ and how you can use Dagger with Kotlin without having a headache."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "This post was inspired by some of the suggestions in this Dagger issue that goes through best practices and pain points of Dagger in Kotlin. Thanks to all of the contributors that commented there!",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 58,
+ 70,
+ "https://github.com/google/dagger/issues/900"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "kapt build improvements"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "To improve your build time, Dagger added support for gradle’s incremental annotation processing in v2.18! This is enabled by default in Dagger v2.24. In case you’re using a lower version, you need to add a few lines of code (as shown below) if you want to benefit from it.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 99,
+ 104,
+ "https://github.com/google/dagger/releases/tag/dagger-2.18"
+ ),
+ Markup(
+ MarkupType.Link,
+ 143,
+ 148,
+ "https://github.com/google/dagger/releases/tag/dagger-2.24"
+ ),
+ Markup(MarkupType.Bold, 53, 95)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Also, you can tell Dagger not to format the generated code. This option was added in Dagger v2.18 and it’s the default behavior (doesn’t generate formatted code) in v2.23. If you’re using a lower version, disable code formatting to improve your build time (see code below).",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 92,
+ 97,
+ "https://github.com/google/dagger/releases/tag/dagger-2.18"
+ ),
+ Markup(
+ MarkupType.Link,
+ 165,
+ 170,
+ "https://github.com/google/dagger/releases/tag/dagger-2.23"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Include these compiler arguments in your build.gradle file to make Dagger more performant at build time:",
+ listOf(Markup(MarkupType.Code, 41, 53))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Alternatively, if you use Kotlin DSL script files, include them like this in the build.gradle.kts file of the modules that use Dagger:",
+ listOf(Markup(MarkupType.Code, 81, 97))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Qualifiers for field attributes"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "",
+ listOf(Markup(MarkupType.Link, 0, 0))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "When an annotation is placed on a property in Kotlin, it’s not clear whether Java will see that annotation on the field of the property or the method for that property. Setting the field: prefix on the annotation ensures that the qualifier ends up in the right place (See documentation for more details).",
+ listOf(
+ Markup(MarkupType.Code, 181, 187),
+ Markup(
+ MarkupType.Link,
+ 268,
+ 285,
+ "http://frogermcs.github.io/dependency-injection-with-dagger-2-custom-scopes/"
+ ),
+ Markup(MarkupType.Italic, 114, 119),
+ Markup(MarkupType.Italic, 143, 149)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "✅ The way to apply qualifiers on an injected field is:"
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "@Inject @field:MinimumBalance lateinit var minimumBalance: BigDecimal",
+ listOf(Markup(MarkupType.Bold, 8, 29))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "❌ As opposed to:"
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ """
+ @Inject @MinimumBalance lateinit var minimumBalance: BigDecimal
+ // @MinimumBalance is ignored!
+ """.trimIndent(),
+ listOf(Markup(MarkupType.Bold, 65, 95))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Forgetting to add field: could lead to injecting the wrong object if there’s an unqualified instance of that type available in the Dagger graph.",
+ listOf(Markup(MarkupType.Code, 18, 24))
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Static @Provides functions optimization"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger’s generated code will be more performant if @Provides methods are static. To achieve this in Kotlin, use a Kotlin object instead of a class and annotate your methods with @JvmStatic. This is a best practice that you should follow as much as possible.",
+ listOf(
+ Markup(MarkupType.Code, 51, 60),
+ Markup(MarkupType.Code, 73, 79),
+ Markup(MarkupType.Code, 121, 127),
+ Markup(MarkupType.Code, 141, 146),
+ Markup(MarkupType.Code, 178, 188),
+ Markup(MarkupType.Bold, 200, 213),
+ Markup(MarkupType.Italic, 200, 213)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "In case you need an abstract method, you’ll need to add the @JvmStatic method to a companion object and annotate it with @Module too.",
+ listOf(
+ Markup(MarkupType.Code, 60, 70),
+ Markup(MarkupType.Code, 121, 128)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Alternatively, you can extract the object module out and include it in the abstract one:"
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Injecting Generics"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Kotlin compiles generics with wildcards to make Kotlin APIs work with Java. These are generated when a type appears as a parameter (more info here) or as fields. For example, a Kotlin List parameter shows up as List in Java.",
+ listOf(
+ Markup(MarkupType.Code, 184, 193),
+ Markup(MarkupType.Code, 216, 233),
+ Markup(
+ MarkupType.Link,
+ 132,
+ 146,
+ "https://kotlinlang.org/docs/reference/java-to-kotlin-interop.html#variant-generics"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "This causes problems with Dagger because it expects an exact (aka invariant) type match. Using @JvmSuppressWildcards will ensure that Dagger sees the type without wildcards.",
+ listOf(
+ Markup(MarkupType.Code, 95, 116),
+ Markup(
+ MarkupType.Link,
+ 66,
+ 75,
+ "https://en.wikipedia.org/wiki/Class_invariant"
+ ),
+ Markup(
+ MarkupType.Link,
+ 96,
+ 116,
+ "https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.jvm/-jvm-suppress-wildcards/index.html"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "This is a common issue when you inject collections using Dagger’s multibinding feature, for example:",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 57,
+ 86,
+ "https://dagger.dev/multibindings.html"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ """
+ class MyVMFactory @Inject constructor(
+ private val vmMap: Map>
+ ) {
+ ...
+ }
+ """.trimIndent(),
+ listOf(Markup(MarkupType.Bold, 72, 93))
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Inline method bodies"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger determines the types that are configured by @Provides methods by inspecting the return type. Specifying the return type in Kotlin functions is optional and even the IDE sometimes encourages you to refactor your code to have inline method bodies that hide the return type declaration.",
+ listOf(Markup(MarkupType.Code, 51, 60))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "This can lead to bugs if the inferred type is different from the one you meant. Let’s see some examples:"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "If you want to add a specific type to the graph, inlining works as expected. See the different ways to do the same in Kotlin:"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "If you want to provide an implementation of an interface, then you must explicitly specify the return type. Not doing it can lead to problems and bugs:"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger mostly works with Kotlin out of the box. However, you have to watch out for a few things just to make sure you’re doing what you really mean to do: @field: for qualifiers on field attributes, inline method bodies, and @JvmSuppressWildcards when injecting collections.",
+ listOf(
+ Markup(MarkupType.Code, 155, 162),
+ Markup(MarkupType.Code, 225, 246)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Dagger optimizations come with no cost, add them and follow best practices to improve your build time: enabling incremental annotation processing, disabling formatting and using static @Provides methods in your Dagger modules.",
+ listOf(
+ Markup(
+ MarkupType.Code,
+ 185,
+ 194
+ )
+ )
+ )
+)
+
+val paragraphsPost3 = listOf(
+ Paragraph(
+ ParagraphType.Text,
+ "Learn how to get started converting Java Programming Language code to Kotlin, making it more idiomatic and avoid common pitfalls, by following our new Refactoring to Kotlin codelab, available in English \uD83C\uDDEC\uD83C\uDDE7, Chinese \uD83C\uDDE8\uD83C\uDDF3 and Brazilian Portuguese \uD83C\uDDE7\uD83C\uDDF7.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 151,
+ 172,
+ "https://codelabs.developers.google.com/codelabs/java-to-kotlin/#0"
+ ),
+ Markup(
+ MarkupType.Link,
+ 209,
+ 216,
+ "https://clmirror.storage.googleapis.com/codelabs/java-to-kotlin-zh/index.html#0"
+ ),
+ Markup(
+ MarkupType.Link,
+ 226,
+ 246,
+ "https://codelabs.developers.google.com/codelabs/java-to-kotlin-pt-br/#0"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "When you first get started writing Kotlin code, you tend to follow Java Programming Language idioms. The automatic converter, part of both Android Studio and Intellij IDEA, can do a pretty good job of automatically refactoring your code, but sometimes, it needs a little help. This is where our new Refactoring to Kotlin codelab comes in.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 105,
+ 124,
+ "https://www.jetbrains.com/help/idea/converting-a-java-file-to-kotlin-file.html"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "We’ll take two classes (a User and a Repository) in Java Programming Language and convert them to Kotlin, check out what the automatic converter did and why. Then we go to the next level — make it idiomatic, teaching best practices and useful tips along the way.",
+ listOf(
+ Markup(MarkupType.Code, 26, 30),
+ Markup(MarkupType.Code, 37, 47)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "The Refactoring to Kotlin codelab starts with basic topics — understand how nullability is declared in Kotlin, what types of equality are defined or how to best handle classes whose role is just to hold data. We then continue with how to handle static fields and functions in Kotlin and how to apply the Singleton pattern, with the help of one handy keyword: object. We’ll see how Kotlin helps us model our classes better, how it differentiates between a property of a class and an action the class can do. Finally, we’ll learn how to execute code only in the context of a specific object with the scope functions.",
+ listOf(
+ Markup(MarkupType.Code, 245, 251),
+ Markup(MarkupType.Code, 359, 365),
+ Markup(
+ MarkupType.Link,
+ 4,
+ 25,
+ "https://codelabs.developers.google.com/codelabs/java-to-kotlin/#0"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Thanks to Walmyr Carvalho and Nelson Glauber for translating the codelab in Brazilian Portuguese!",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 21,
+ 42,
+ "https://codelabs.developers.google.com/codelabs/java-to-kotlin/#0"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 76,
+ 96,
+ "https://codelabs.developers.google.com/codelabs/java-to-kotlin-pt-br/#0"
+ )
+ )
+ )
+)
+
+val paragraphsPost4 = listOf(
+ Paragraph(
+ ParagraphType.Text,
+ "TL;DR: Expose resource IDs from ViewModels to avoid showing obsolete data."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "In a ViewModel, if you’re exposing data coming from resources (strings, drawables, colors…), you have to take into account that ViewModel objects ignore configuration changes such as locale changes. When the user changes their locale, activities are recreated but the ViewModel objects are not.",
+ listOf(
+ Markup(
+ MarkupType.Bold,
+ 183,
+ 197
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "AndroidViewModel is a subclass of ViewModel that is aware of the Application context. However, having access to a context can be dangerous if you’re not observing or reacting to the lifecycle of that context. The recommended practice is to avoid dealing with objects that have a lifecycle in ViewModels.",
+ listOf(
+ Markup(MarkupType.Code, 0, 16),
+ Markup(MarkupType.Code, 34, 43),
+ Markup(MarkupType.Bold, 209, 303)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Let’s look at an example based on this issue in the tracker: Updating ViewModel on system locale change.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 61,
+ 103,
+ "https://issuetracker.google.com/issues/111961971"
+ ),
+ Markup(MarkupType.Italic, 61, 104)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "The problem is that the string is resolved in the constructor only once. If there’s a locale change, the ViewModel won’t be recreated. This will result in our app showing obsolete data and therefore being only partially localized.",
+ listOf(Markup(MarkupType.Bold, 73, 133))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "As Sergey points out in the comments to the issue, the recommended approach is to expose the ID of the resource you want to load and do so in the view. As the view (activity, fragment, etc.) is lifecycle-aware it will be recreated after a configuration change so the resource will be reloaded correctly.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 3,
+ 9,
+ "https://twitter.com/ZelenetS"
+ ),
+ Markup(
+ MarkupType.Link,
+ 28,
+ 36,
+ "https://issuetracker.google.com/issues/111961971#comment2"
+ ),
+ Markup(MarkupType.Bold, 82, 150)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Even if you don’t plan to localize your app, it makes testing much easier and cleans up your ViewModel objects so there’s no reason not to future-proof."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "We fixed this issue in the android-architecture repository in the Java and Kotlin branches and we offloaded resource loading to the Data Binding layout.",
+ listOf(
+ Markup(
+ MarkupType.Link,
+ 66,
+ 70,
+ "https://github.com/googlesamples/android-architecture/pull/631"
+ ),
+ Markup(
+ MarkupType.Link,
+ 75,
+ 81,
+ "https://github.com/googlesamples/android-architecture/pull/635"
+ ),
+ Markup(
+ MarkupType.Link,
+ 128,
+ 151,
+ "https://github.com/googlesamples/android-architecture/pull/635/files#diff-7eb5d85ec3ea4e05ecddb7dc8ae20aa1R62"
+ )
+ )
+ )
+)
+
+val paragraphsPost5 = listOf(
+ Paragraph(
+ ParagraphType.Text,
+ "Working with collections is a common task and the Kotlin Standard Library offers many great utility functions. It also offers two ways of working with collections based on how they’re evaluated: eagerly — with Collections, and lazily — with Sequences. Continue reading to find out what’s the difference between the two, which one you should use and when, and what the performance implications of each are.",
+ listOf(
+ Markup(MarkupType.Code, 210, 220),
+ Markup(MarkupType.Code, 241, 249),
+ Markup(
+ MarkupType.Link,
+ 210,
+ 221,
+ "https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index.html"
+ ),
+ Markup(
+ MarkupType.Link,
+ 241,
+ 250,
+ "https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.sequences/index.html"
+ ),
+ Markup(MarkupType.Bold, 130, 134),
+ Markup(MarkupType.Bold, 195, 202),
+ Markup(MarkupType.Bold, 227, 233),
+ Markup(MarkupType.Italic, 130, 134)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Collections vs sequences"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "The difference between eager and lazy evaluation lies in when each transformation on the collection is performed.",
+ listOf(
+ Markup(
+ MarkupType.Italic,
+ 57,
+ 61
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Collections are eagerly evaluated — each operation is performed when it’s called and the result of the operation is stored in a new collection. The transformations on collections are inline functions. For example, looking at how map is implemented, we can see that it’s an inline function, that creates a new ArrayList:",
+ listOf(
+ Markup(MarkupType.Code, 229, 232),
+ Markup(MarkupType.Code, 273, 279),
+ Markup(MarkupType.Code, 309, 318),
+ Markup(
+ MarkupType.Link,
+ 183,
+ 199,
+ "https://kotlinlang.org/docs/reference/inline-functions.html"
+ ),
+ Markup(
+ MarkupType.Link,
+ 229,
+ 232,
+ "https://github.com/JetBrains/kotlin/blob/master/libraries/stdlib/common/src/generated/_Collections.kt#L1312"
+ ),
+ Markup(MarkupType.Bold, 0, 12),
+ Markup(MarkupType.Italic, 16, 23)
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "public inline fun Iterable.map(transform: (T) -> R): List {\n" +
+ " return mapTo(ArrayList(collectionSizeOrDefault(10)), transform)\n" +
+ "}",
+ listOf(
+ Markup(MarkupType.Bold, 7, 13),
+ Markup(MarkupType.Bold, 88, 97)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Sequences are lazily evaluated. They have two types of operations: intermediate and terminal. Intermediate operations are not performed on the spot; they’re just stored. Only when a terminal operation is called, the intermediate operations are triggered on each element in a row and finally, the terminal operation is applied. Intermediate operations (like map, distinct, groupBy etc) return another sequence whereas terminal operations (like first, toList, count etc) don’t.",
+ listOf(
+ Markup(MarkupType.Code, 357, 360),
+ Markup(MarkupType.Code, 362, 370),
+ Markup(MarkupType.Code, 372, 379),
+ Markup(MarkupType.Code, 443, 448),
+ Markup(MarkupType.Code, 450, 456),
+ Markup(MarkupType.Code, 458, 463),
+ Markup(MarkupType.Bold, 0, 9),
+ Markup(MarkupType.Bold, 67, 79),
+ Markup(MarkupType.Bold, 84, 92),
+ Markup(MarkupType.Bold, 254, 269),
+ Markup(MarkupType.Italic, 14, 20)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Sequences don’t hold a reference to the items of the collection. They’re created based on the iterator of the original collection and keep a reference to all the intermediate operations that need to be performed."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Unlike transformations on collections, intermediate transformations on sequences are not inline functions — inline functions cannot be stored and sequences need to store them. Looking at how an intermediate operation like map is implemented, we can see that the transform function is kept in a new instance of a Sequence:",
+ listOf(
+ Markup(MarkupType.Code, 222, 225),
+ Markup(MarkupType.Code, 312, 320),
+ Markup(
+ MarkupType.Link,
+ 222,
+ 225,
+ "https://github.com/JetBrains/kotlin/blob/master/libraries/stdlib/common/src/generated/_Sequences.kt#L860"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "public fun Sequence.map(transform: (T) -> R): Sequence{ \n" +
+ " return TransformingSequence(this, transform)\n" +
+ "}",
+ listOf(Markup(MarkupType.Bold, 85, 105))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "A terminal operation, like first, iterates through the elements of the sequence until the predicate condition is matched.",
+ listOf(
+ Markup(MarkupType.Code, 27, 32),
+ Markup(
+ MarkupType.Link,
+ 27,
+ 32,
+ "https://github.com/JetBrains/kotlin/blob/master/libraries/stdlib/common/src/generated/_Sequences.kt#L117"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "public inline fun Sequence.first(predicate: (T) -> Boolean): T {\n" +
+ " for (element in this) if (predicate(element)) return element\n" +
+ " throw NoSuchElementException(“Sequence contains no element matching the predicate.”)\n" +
+ "}"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "If we look at how a sequence like TransformingSequence (used in the map above) is implemented, we’ll see that when next is called on the sequence iterator, the transformation stored is also applied.",
+ listOf(
+ Markup(MarkupType.Code, 34, 54),
+ Markup(MarkupType.Code, 68, 71)
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "internal class TransformingIndexedSequence \n" +
+ "constructor(private val sequence: Sequence, private val transformer: (Int, T) -> R) : Sequence {",
+ listOf(
+ Markup(
+ MarkupType.Bold,
+ 109,
+ 120
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.CodeBlock,
+ "override fun iterator(): Iterator = object : Iterator {\n" +
+ " …\n" +
+ " override fun next(): R {\n" +
+ " return transformer(checkIndexOverflow(index++), iterator.next())\n" +
+ " }\n" +
+ " …\n" +
+ "}",
+ listOf(
+ Markup(MarkupType.Bold, 83, 89),
+ Markup(MarkupType.Bold, 107, 118)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Independent on whether you’re using collections or sequences, the Kotlin Standard Library offers quite a wide range of operations for both, like find, filter, groupBy and others. Make sure you check them out, before implementing your own version of these.",
+ listOf(
+ Markup(MarkupType.Code, 145, 149),
+ Markup(MarkupType.Code, 151, 157),
+ Markup(MarkupType.Code, 159, 166),
+ Markup(
+ MarkupType.Link,
+ 193,
+ 207,
+ "https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/#functions"
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Collections and sequences"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Let’s say that we have a list of objects of different shapes. We want to make the shapes yellow and then take the first square shape."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Let’s see how and when each operation is applied for collections and when for sequences"
+ ),
+ Paragraph(
+ ParagraphType.Subhead,
+ "Collections"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "map is called — a new ArrayList is created. We iterate through all items of the initial collection, transform it by copying the original object and changing the color, then add it to the new list.",
+ listOf(Markup(MarkupType.Code, 0, 3))
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "first is called — we iterate through each item until the first square is found",
+ listOf(Markup(MarkupType.Code, 0, 5))
+ ),
+ Paragraph(
+ ParagraphType.Subhead,
+ "Sequences"
+ ),
+ Paragraph(
+ ParagraphType.Bullet,
+ "asSequence — a sequence is created based on the Iterator of the original collection",
+ listOf(Markup(MarkupType.Code, 0, 10))
+ ),
+ Paragraph(
+ ParagraphType.Bullet,
+ "map is called — the transformation is added to the list of operations needed to be performed by the sequence but the operation is NOT performed",
+ listOf(
+ Markup(MarkupType.Code, 0, 3),
+ Markup(MarkupType.Bold, 130, 133)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Bullet,
+ "first is called — this is a terminal operation, so, all the intermediate operations are triggered, on each element of the collection. We iterate through the initial collection applying map and then first on each of them. Since the condition from first is satisfied by the 2nd element, then we no longer apply the map on the rest of the collection.",
+ listOf(Markup(MarkupType.Code, 0, 5))
+ ),
+
+ Paragraph(
+ ParagraphType.Text,
+ "When working with sequences no intermediate collection is created and since items are evaluated one by one, map is only performed on some of the inputs."
+ ),
+ Paragraph(
+ ParagraphType.Header,
+ "Performance"
+ ),
+ Paragraph(
+ ParagraphType.Subhead,
+ "Order of transformations"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Independent of whether you’re using collections or sequences, the order of transformations matters. In the example above, first doesn’t need to happen after map since it’s not a consequence of the map transformation. If we reverse the order of our business logic and call first on the collection and then transform the result, then we only create one new object — the yellow square. When using sequences — we avoid creating 2 new objects, when using collections, we avoid creating an entire new list.",
+ listOf(
+ Markup(MarkupType.Code, 122, 127),
+ Markup(MarkupType.Code, 157, 160),
+ Markup(MarkupType.Code, 197, 200)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Because terminal operations can finish processing early, and intermediate operations are evaluated lazily, sequences can, in some cases, help you avoid doing unnecessary work compared to collections. Make sure you always check the order of the transformations and the dependencies between them!"
+ ),
+ Paragraph(
+ ParagraphType.Subhead,
+ "Inlining and large data sets consequences"
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Collection operations use inline functions, so the bytecode of the operation, together with the bytecode of the lambda passed to it will be inlined. Sequences don’t use inline functions, therefore, new Function objects are created for each operation.",
+ listOf(
+ Markup(
+ MarkupType.Code,
+ 202,
+ 210
+ )
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "On the other hand, collections create a new list for every transformation while sequences just keep a reference to the transformation function."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "When working with small collections, with 1–2 operators, these differences don’t have big implications so working with collections should be ok. But, when working with large lists the intermediate collection creation can become expensive; in such cases, use sequences.",
+ listOf(
+ Markup(MarkupType.Bold, 18, 35),
+ Markup(MarkupType.Bold, 119, 130),
+ Markup(MarkupType.Bold, 168, 179),
+ Markup(MarkupType.Bold, 258, 267)
+ )
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Unfortunately, I’m not aware of any benchmarking study done that would help us get a better understanding on how the performance of collections vs sequences is affected with different sizes of collections or operation chains."
+ ),
+ Paragraph(
+ ParagraphType.Text,
+ "Collections eagerly evaluate your data while sequences do so lazily. Depending on the size of your data, pick the one that fits best: collections — for small lists or sequences — for larger ones, and pay attention to the order of the transformations."
+ )
+)
+
+val post1 = Post(
+ id = "dc523f0ed25c",
+ title = "A Little Thing about Android Module Paths",
+ subtitle = "How to configure your module paths, instead of using Gradle’s default.",
+ url = "https://medium.com/androiddevelopers/gradle-path-configuration-dc523f0ed25c",
+ publication = publication,
+ metadata = Metadata(
+ author = pietro,
+ date = "August 02",
+ readTimeMinutes = 1
+ ),
+ paragraphs = paragraphsPost1,
+ imageId = R.drawable.post_1,
+ imageThumbId = R.drawable.post_1_thumb
+)
+
+val post2 = Post(
+ id = "7446d8dfd7dc",
+ title = "Dagger in Kotlin: Gotchas and Optimizations",
+ subtitle = "Use Dagger in Kotlin! This article includes best practices to optimize your build time and gotchas you might encounter.",
+ url = "https://medium.com/androiddevelopers/dagger-in-kotlin-gotchas-and-optimizations-7446d8dfd7dc",
+ publication = publication,
+ metadata = Metadata(
+ author = manuel,
+ date = "July 30",
+ readTimeMinutes = 3
+ ),
+ paragraphs = paragraphsPost2,
+ imageId = R.drawable.post_2,
+ imageThumbId = R.drawable.post_2_thumb
+)
+
+val post3 = Post(
+ id = "ac552dcc1741",
+ title = "From Java Programming Language to Kotlin — the idiomatic way",
+ subtitle = "Learn how to get started converting Java Programming Language code to Kotlin, making it more idiomatic and avoid common pitfalls, by…",
+ url = "https://medium.com/androiddevelopers/from-java-programming-language-to-kotlin-the-idiomatic-way-ac552dcc1741",
+ publication = publication,
+ metadata = Metadata(
+ author = florina,
+ date = "July 09",
+ readTimeMinutes = 1
+ ),
+ paragraphs = paragraphsPost3,
+ imageId = R.drawable.post_3,
+ imageThumbId = R.drawable.post_3_thumb
+)
+
+val post4 = Post(
+ id = "84eb677660d9",
+ title = "Locale changes and the AndroidViewModel antipattern",
+ subtitle = "TL;DR: Expose resource IDs from ViewModels to avoid showing obsolete data.",
+ url = "https://medium.com/androiddevelopers/locale-changes-and-the-androidviewmodel-antipattern-84eb677660d9",
+ publication = publication,
+ metadata = Metadata(
+ author = jose,
+ date = "April 02",
+ readTimeMinutes = 1
+ ),
+ paragraphs = paragraphsPost4,
+ imageId = R.drawable.post_4,
+ imageThumbId = R.drawable.post_4_thumb
+)
+
+val post5 = Post(
+ id = "55db18283aca",
+ title = "Collections and sequences in Kotlin",
+ subtitle = "Working with collections is a common task and the Kotlin Standard Library offers many great utility functions. It also offers two ways of…",
+ url = "https://medium.com/androiddevelopers/collections-and-sequences-in-kotlin-55db18283aca",
+ publication = publication,
+ metadata = Metadata(
+ author = florina,
+ date = "July 24",
+ readTimeMinutes = 4
+ ),
+ paragraphs = paragraphsPost5,
+ imageId = R.drawable.post_5,
+ imageThumbId = R.drawable.post_5_thumb
+)
+
+val posts: List =
+ listOf(
+ post1,
+ post2,
+ post3,
+ post4,
+ post5,
+ post1.copy(id = "post6"),
+ post2.copy(id = "post7"),
+ post3.copy(id = "post8"),
+ post4.copy(id = "post9"),
+ post5.copy(id = "post10")
+ )
\ No newline at end of file
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsRepository.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsRepository.kt
new file mode 100644
index 000000000..cb51202dc
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/data/posts/PostsRepository.kt
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.data.posts
+
+import com.example.jetnews.data.posts.impl.posts
+import com.example.jetnews.model.Post
+import com.example.jetnews.utils.addOrRemove
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableStateFlow
+
+/**
+ * Simplified implementation of PostsRepository that returns a hardcoded list of
+ * posts with resources synchronously.
+ */
+class PostsRepository {
+ // for now, keep the favorites in memory
+ private val favorites = MutableStateFlow>(setOf())
+
+ /**
+ * Get a specific JetNews post.
+ */
+ fun getPost(postId: String?): Post? {
+ return posts.find { it.id == postId }
+ }
+
+ /**
+ * Get JetNews posts.
+ */
+ fun getPosts(): List {
+ return posts
+ }
+
+ /**
+ * Observe the current favorites
+ */
+ fun observeFavorites(): Flow> = favorites
+
+ /**
+ * Toggle a postId to be a favorite or not.
+ */
+ fun toggleFavorite(postId: String) {
+ val set = favorites.value.toMutableSet()
+ set.addOrRemove(postId)
+ favorites.value = set
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/model/Post.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/model/Post.kt
new file mode 100644
index 000000000..40e8977e7
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/model/Post.kt
@@ -0,0 +1,78 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.model
+
+import androidx.annotation.DrawableRes
+
+data class Post(
+ val id: String,
+ val title: String,
+ val subtitle: String? = null,
+ val url: String,
+ val publication: Publication? = null,
+ val metadata: Metadata,
+ val paragraphs: List = emptyList(),
+ @DrawableRes val imageId: Int,
+ @DrawableRes val imageThumbId: Int
+)
+
+data class Metadata(
+ val author: PostAuthor,
+ val date: String,
+ val readTimeMinutes: Int
+)
+
+data class PostAuthor(
+ val name: String,
+ val url: String? = null
+)
+
+data class Publication(
+ val name: String,
+ val logoUrl: String
+)
+
+data class Paragraph(
+ val type: ParagraphType,
+ val text: String,
+ val markups: List = emptyList()
+)
+
+data class Markup(
+ val type: MarkupType,
+ val start: Int,
+ val end: Int,
+ val href: String? = null
+)
+
+enum class MarkupType {
+ Link,
+ Code,
+ Italic,
+ Bold,
+}
+
+enum class ParagraphType {
+ Title,
+ Caption,
+ Header,
+ Subhead,
+ Text,
+ CodeBlock,
+ Quote,
+ Bullet,
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/AppDrawer.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/AppDrawer.kt
new file mode 100644
index 000000000..b5682d1d3
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/AppDrawer.kt
@@ -0,0 +1,174 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui
+
+import android.content.res.Configuration.UI_MODE_NIGHT_YES
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
+import androidx.compose.material3.Divider
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Home
+import androidx.compose.material.icons.filled.ListAlt
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.ColorFilter
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import com.example.jetnews.R
+import com.example.jetnews.ui.theme.JetnewsTheme
+
+@Composable
+fun AppDrawer(
+ currentRoute: String,
+ navigateToHome: () -> Unit,
+ navigateToInterests: () -> Unit,
+ closeDrawer: () -> Unit
+) {
+
+ Column(modifier = Modifier.fillMaxSize()) {
+ Spacer(Modifier.height(24.dp))
+ JetNewsLogo(Modifier.padding(16.dp))
+ Divider(color = MaterialTheme.colorScheme.onSurface.copy(alpha = .2f))
+ DrawerButton(
+ icon = Icons.Filled.Home,
+ label = "Home",
+ isSelected = currentRoute == MainDestinations.HOME_ROUTE,
+ action = {
+ navigateToHome()
+ closeDrawer()
+ }
+ )
+
+ DrawerButton(
+ icon = Icons.Filled.ListAlt,
+ label = "Interests",
+ isSelected = currentRoute == MainDestinations.INTERESTS_ROUTE,
+ action = {
+ navigateToInterests()
+ closeDrawer()
+ }
+ )
+ }
+}
+
+@Composable
+private fun JetNewsLogo(modifier: Modifier = Modifier) {
+ Row(modifier = modifier) {
+ Image(
+ painter = painterResource(R.drawable.ic_jetnews_logo),
+ contentDescription = null,
+ colorFilter = ColorFilter.tint(MaterialTheme.colorScheme.primary)
+ )
+ Spacer(Modifier.width(8.dp))
+ Image(
+ painter = painterResource(R.drawable.ic_jetnews_wordmark),
+ contentDescription = null,
+ colorFilter = ColorFilter.tint(MaterialTheme.colorScheme.onSurface)
+ )
+ }
+}
+
+@Composable
+private fun DrawerButton(
+ icon: ImageVector,
+ label: String,
+ isSelected: Boolean,
+ action: () -> Unit,
+ modifier: Modifier = Modifier
+) {
+ val colors = MaterialTheme.colorScheme
+ val imageAlpha = if (isSelected) {
+ 1f
+ } else {
+ 0.6f
+ }
+ val textIconColor = if (isSelected) {
+ colors.primary
+ } else {
+ colors.onSurface.copy(alpha = 0.6f)
+ }
+ val backgroundColor = if (isSelected) {
+ colors.primary.copy(alpha = 0.12f)
+ } else {
+ Color.Transparent
+ }
+
+ val surfaceModifier = modifier
+ .padding(start = 8.dp, top = 8.dp, end = 8.dp)
+ .fillMaxWidth()
+ Surface(
+ modifier = surfaceModifier,
+ color = backgroundColor,
+ shape = MaterialTheme.shapes.small
+ ) {
+ TextButton(
+ onClick = action,
+ modifier = Modifier.fillMaxWidth()
+ ) {
+ Row(
+ horizontalArrangement = Arrangement.Start,
+ verticalAlignment = Alignment.CenterVertically,
+ modifier = Modifier.fillMaxWidth()
+ ) {
+ Image(
+ imageVector = icon,
+ contentDescription = null,
+ colorFilter = ColorFilter.tint(textIconColor),
+ alpha = imageAlpha
+ )
+ Spacer(Modifier.width(16.dp))
+ Text(
+ text = label,
+ style = MaterialTheme.typography.bodyMedium,
+ color = textIconColor
+ )
+ }
+ }
+ }
+}
+
+@Preview("Drawer contents")
+@Preview("Drawer contents (dark)", uiMode = UI_MODE_NIGHT_YES)
+@Composable
+fun PreviewAppDrawer() {
+ JetnewsTheme {
+ Surface {
+ AppDrawer(
+ currentRoute = MainDestinations.HOME_ROUTE,
+ navigateToHome = {},
+ navigateToInterests = {},
+ closeDrawer = { }
+ )
+ }
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsApp.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsApp.kt
new file mode 100644
index 000000000..c8e3e2e11
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsApp.kt
@@ -0,0 +1,84 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui
+
+import android.annotation.SuppressLint
+import androidx.compose.foundation.layout.WindowInsets
+import androidx.compose.foundation.layout.width
+import androidx.compose.material3.DrawerValue
+import androidx.compose.material3.ModalDrawerSheet
+import androidx.compose.material3.ModalNavigationDrawer
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.rememberDrawerState
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.SideEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.unit.dp
+import androidx.navigation.compose.currentBackStackEntryAsState
+import androidx.navigation.compose.rememberNavController
+import com.example.jetnews.data.AppContainer
+import com.example.jetnews.ui.theme.JetnewsTheme
+import com.google.accompanist.systemuicontroller.rememberSystemUiController
+import kotlinx.coroutines.launch
+
+@SuppressLint("UnusedMaterialScaffoldPaddingParameter", "UnusedMaterial3ScaffoldPaddingParameter")
+@Composable
+fun JetnewsApp(
+ appContainer: AppContainer
+) {
+ JetnewsTheme {
+ val systemUiController = rememberSystemUiController()
+ SideEffect {
+ systemUiController.setSystemBarsColor(Color.Transparent, darkIcons = false)
+ }
+
+ val navController = rememberNavController()
+ val coroutineScope = rememberCoroutineScope()
+
+ val navBackStackEntry by navController.currentBackStackEntryAsState()
+ val currentRoute = navBackStackEntry?.destination?.route ?: MainDestinations.HOME_ROUTE
+
+ val drawerState = rememberDrawerState(DrawerValue.Closed)
+ val scope = rememberCoroutineScope()
+
+ ModalNavigationDrawer(
+ drawerState = drawerState,
+ drawerContent = {
+ ModalDrawerSheet(modifier = Modifier.width(300.dp), windowInsets = WindowInsets(0.dp, 0.dp, 0.dp, 0.dp)) {
+ AppDrawer(
+ currentRoute = currentRoute,
+ navigateToHome = { navController.navigate(MainDestinations.HOME_ROUTE) },
+ navigateToInterests = { navController.navigate(MainDestinations.INTERESTS_ROUTE) },
+ closeDrawer = { coroutineScope.launch { drawerState.close() } }
+ )
+ }
+ },
+ content = {
+ Scaffold {
+ JetnewsNavGraph(
+ appContainer = appContainer,
+ navController = navController,
+ drawerState = drawerState
+ )
+ }
+ }
+ )
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsNavGraph.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsNavGraph.kt
new file mode 100644
index 000000000..525920efe
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/JetnewsNavGraph.kt
@@ -0,0 +1,94 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui
+
+import androidx.compose.material3.DrawerState
+import androidx.compose.material3.DrawerValue
+import androidx.compose.material3.rememberDrawerState
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.navigation.NavHostController
+import androidx.navigation.compose.NavHost
+import androidx.navigation.compose.composable
+import androidx.navigation.compose.rememberNavController
+import com.example.jetnews.data.AppContainer
+import com.example.jetnews.ui.MainDestinations.ARTICLE_ID_KEY
+import com.example.jetnews.ui.article.ArticleScreen
+import com.example.jetnews.ui.home.HomeScreen
+import com.example.jetnews.ui.interests.InterestsScreen
+import kotlinx.coroutines.launch
+
+/**
+ * Destinations used in the ([JetnewsApp]).
+ */
+object MainDestinations {
+ const val HOME_ROUTE = "home"
+ const val INTERESTS_ROUTE = "interests"
+ const val ARTICLE_ROUTE = "post"
+ const val ARTICLE_ID_KEY = "postId"
+}
+
+@Composable
+fun JetnewsNavGraph(
+ appContainer: AppContainer,
+ navController: NavHostController = rememberNavController(),
+ drawerState: DrawerState = rememberDrawerState(DrawerValue.Closed),
+ startDestination: String = MainDestinations.HOME_ROUTE
+) {
+ val actions = remember(navController) { MainActions(navController) }
+ val coroutineScope = rememberCoroutineScope()
+ val openDrawer: () -> Unit = { coroutineScope.launch { drawerState.open() } }
+
+ NavHost(
+ navController = navController,
+ startDestination = startDestination
+ ) {
+ composable(MainDestinations.HOME_ROUTE) {
+ HomeScreen(
+ postsRepository = appContainer.postsRepository,
+ navigateToArticle = actions.navigateToArticle,
+ openDrawer = openDrawer
+ )
+ }
+ composable(MainDestinations.INTERESTS_ROUTE) {
+ InterestsScreen(
+ interestsRepository = appContainer.interestsRepository,
+ openDrawer = openDrawer
+ )
+ }
+ composable("${MainDestinations.ARTICLE_ROUTE}/{$ARTICLE_ID_KEY}") { backStackEntry ->
+ ArticleScreen(
+ postId = backStackEntry.arguments?.getString(ARTICLE_ID_KEY),
+ onBack = actions.upPress,
+ postsRepository = appContainer.postsRepository
+ )
+ }
+ }
+}
+
+/**
+ * Models the navigation actions in the app.
+ */
+class MainActions(navController: NavHostController) {
+ val navigateToArticle: (String) -> Unit = { postId: String ->
+ navController.navigate("${MainDestinations.ARTICLE_ROUTE}/$postId")
+ }
+ val upPress: () -> Unit = {
+ navController.navigateUp()
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/MainActivity.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/MainActivity.kt
new file mode 100644
index 000000000..8d379188b
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/MainActivity.kt
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui
+
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.core.view.WindowCompat
+import com.example.jetnews.JetnewsApplication
+
+class MainActivity : ComponentActivity() {
+
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ WindowCompat.setDecorFitsSystemWindows(window, false)
+
+ val appContainer = (application as JetnewsApplication).container
+ setContent {
+ JetnewsApp(appContainer)
+ }
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/ArticleScreen.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/ArticleScreen.kt
new file mode 100644
index 000000000..45d401d57
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/ArticleScreen.kt
@@ -0,0 +1,154 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.article
+
+import android.content.res.Configuration.UI_MODE_NIGHT_YES
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.AlertDialog
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.LocalContentColor
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.ArrowBack
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.saveable.rememberSaveable
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.tooling.preview.Devices
+import androidx.compose.ui.tooling.preview.Preview
+import com.example.jetnews.R
+import com.example.jetnews.data.posts.PostsRepository
+import com.example.jetnews.data.posts.impl.post3
+import com.example.jetnews.model.Post
+import com.example.jetnews.ui.components.InsetAwareTopAppBar
+import com.example.jetnews.ui.theme.JetnewsTheme
+import com.example.jetnews.utils.supportWideScreen
+
+/**
+ * Stateful Article Screen that manages state using [produceUiState]
+ *
+ * @param postId (state) the post to show
+ * @param postsRepository data source for this screen
+ * @param onBack (event) request back navigation
+ */
+@Suppress("DEPRECATION") // allow ViewModelLifecycleScope call
+@Composable
+fun ArticleScreen(
+ postId: String?,
+ postsRepository: PostsRepository,
+ onBack: () -> Unit
+) {
+ val postData = postsRepository.getPost(postId)!!
+
+ ArticleScreen(
+ post = postData,
+ onBack = onBack
+ )
+}
+
+/**
+ * Stateless Article Screen that displays a single post.
+ *
+ * @param post (state) item to display
+ * @param onBack (event) request navigate back
+ */
+@Composable
+fun ArticleScreen(
+ post: Post,
+ onBack: () -> Unit
+) {
+
+ var showDialog by rememberSaveable { mutableStateOf(false) }
+ if (showDialog) {
+ FunctionalityNotAvailablePopup { showDialog = false }
+ }
+
+ Scaffold(
+ topBar = {
+ InsetAwareTopAppBar(
+ title = {
+ Text(
+ text = "Published in: ${post.publication?.name}",
+ style = MaterialTheme.typography.titleSmall,
+ color = LocalContentColor.current
+ )
+ },
+ navigationIcon = {
+ IconButton(onClick = onBack) {
+ Icon(
+ imageVector = Icons.Filled.ArrowBack,
+ // Step 4: Content descriptions
+ contentDescription = stringResource(
+ R.string.cd_navigate_up
+ )
+ )
+ }
+ }
+ )
+ }
+ ) { innerPadding ->
+ PostContent(
+ post = post,
+ modifier = Modifier
+ // innerPadding takes into account the top and bottom bar
+ .padding(innerPadding)
+ // center content in landscape mode
+ .supportWideScreen()
+ )
+ }
+}
+
+/**
+ * Display a popup explaining functionality not available.
+ *
+ * @param onDismiss (event) request the popup be dismissed
+ */
+@Composable
+private fun FunctionalityNotAvailablePopup(onDismiss: () -> Unit) {
+ AlertDialog(
+ onDismissRequest = onDismiss,
+ text = {
+ Text(
+ text = "Functionality not available \uD83D\uDE48",
+ style = MaterialTheme.typography.bodyMedium
+ )
+ },
+ confirmButton = {
+ TextButton(onClick = onDismiss) {
+ Text(text = "CLOSE")
+ }
+ }
+ )
+}
+
+@Preview("Article screen")
+@Preview("Article screen (dark)", uiMode = UI_MODE_NIGHT_YES)
+@Preview("Article screen (big font)", fontScale = 1.5f)
+@Preview("Article screen (large screen)", device = Devices.PIXEL_C)
+@Composable
+fun PreviewArticle() {
+ JetnewsTheme {
+ ArticleScreen(PostsRepository().getPost(post3.id)!!, {})
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/PostContent.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/PostContent.kt
new file mode 100644
index 000000000..ff74a7166
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/article/PostContent.kt
@@ -0,0 +1,354 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.article
+
+import android.content.res.Configuration.UI_MODE_NIGHT_YES
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.background
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.heightIn
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.material3.LocalContentColor
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material3.Typography
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.AccountCircle
+import androidx.compose.material3.ColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.ColorFilter
+import androidx.compose.ui.layout.ContentScale
+import androidx.compose.ui.layout.FirstBaseline
+import androidx.compose.ui.platform.LocalDensity
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.semantics.heading
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.text.AnnotatedString
+import androidx.compose.ui.text.ParagraphStyle
+import androidx.compose.ui.text.SpanStyle
+import androidx.compose.ui.text.TextStyle
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.text.font.FontStyle
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.text.style.TextDecoration
+import androidx.compose.ui.text.style.TextIndent
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.dp
+import androidx.compose.ui.unit.sp
+import com.example.jetnews.data.posts.impl.post3
+import com.example.jetnews.model.Markup
+import com.example.jetnews.model.MarkupType
+import com.example.jetnews.model.Metadata
+import com.example.jetnews.model.Paragraph
+import com.example.jetnews.model.ParagraphType
+import com.example.jetnews.model.Post
+import com.example.jetnews.ui.theme.JetnewsTheme
+
+private val defaultSpacerSize = 16.dp
+
+@Composable
+fun PostContent(post: Post, modifier: Modifier = Modifier) {
+ LazyColumn(
+ modifier = modifier.padding(horizontal = defaultSpacerSize)
+ ) {
+ item {
+ Spacer(Modifier.height(defaultSpacerSize))
+ PostHeaderImage(post)
+ }
+ item {
+ Text(text = post.title, style = MaterialTheme.typography.headlineMedium)
+ Spacer(Modifier.height(8.dp))
+ }
+ post.subtitle?.let { subtitle ->
+ item {
+ CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurfaceVariant) {
+ Text(
+ text = subtitle,
+ style = MaterialTheme.typography.bodyMedium,
+ lineHeight = 20.sp
+ )
+ }
+ Spacer(Modifier.height(defaultSpacerSize))
+ }
+ }
+ item {
+ PostMetadata(post.metadata)
+ Spacer(Modifier.height(24.dp))
+ }
+ items(post.paragraphs) {
+ Paragraph(paragraph = it)
+ }
+ item {
+ Spacer(Modifier.height(48.dp))
+ }
+ }
+}
+
+@Composable
+private fun PostHeaderImage(post: Post) {
+ val imageModifier = Modifier
+ .heightIn(min = 180.dp)
+ .fillMaxWidth()
+ .clip(shape = MaterialTheme.shapes.medium)
+ Image(
+ painter = painterResource(post.imageId),
+ contentDescription = null,
+ modifier = imageModifier,
+ contentScale = ContentScale.Crop
+ )
+ Spacer(Modifier.height(defaultSpacerSize))
+}
+
+@Composable
+private fun PostMetadata(metadata: Metadata) {
+ val typography = MaterialTheme.typography
+ // Step 6: Custom merging
+ Row(Modifier.semantics(mergeDescendants = true) {}) {
+ Image(
+ imageVector = Icons.Filled.AccountCircle,
+ contentDescription = null,
+ modifier = Modifier.size(40.dp),
+ colorFilter = ColorFilter.tint(LocalContentColor.current),
+ contentScale = ContentScale.Fit
+ )
+ Spacer(Modifier.width(8.dp))
+ Column {
+ Text(
+ text = metadata.author.name,
+ style = typography.bodySmall,
+ modifier = Modifier.padding(top = 4.dp)
+ )
+
+ CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurfaceVariant) {
+ Text(
+ text = "${metadata.date} • ${metadata.readTimeMinutes} min read",
+ style = typography.bodySmall
+ )
+ }
+ }
+ }
+}
+
+@Composable
+private fun Paragraph(paragraph: Paragraph) {
+ val (textStyle, paragraphStyle, trailingPadding) = paragraph.type.getTextAndParagraphStyle()
+
+ val annotatedString = paragraphToAnnotatedString(
+ paragraph,
+ MaterialTheme.typography,
+ MaterialTheme.colorScheme.codeBlockBackground
+ )
+ Box(modifier = Modifier.padding(bottom = trailingPadding)) {
+ when (paragraph.type) {
+ ParagraphType.Bullet -> BulletParagraph(
+ text = annotatedString,
+ textStyle = textStyle,
+ paragraphStyle = paragraphStyle
+ )
+ ParagraphType.CodeBlock -> CodeBlockParagraph(
+ text = annotatedString,
+ textStyle = textStyle,
+ paragraphStyle = paragraphStyle
+ )
+ ParagraphType.Header -> {
+ Text(
+ modifier = Modifier.padding(4.dp)
+ // Step 5: Headings
+ .semantics { heading() },
+ text = annotatedString,
+ style = textStyle.merge(paragraphStyle)
+ )
+ }
+ else -> Text(
+ modifier = Modifier.padding(4.dp),
+ text = annotatedString,
+ style = textStyle
+ )
+ }
+ }
+}
+
+@Composable
+private fun CodeBlockParagraph(
+ text: AnnotatedString,
+ textStyle: TextStyle,
+ paragraphStyle: ParagraphStyle
+) {
+ Surface(
+ color = MaterialTheme.colorScheme.codeBlockBackground,
+ shape = MaterialTheme.shapes.small,
+ modifier = Modifier.fillMaxWidth()
+ ) {
+ Text(
+ modifier = Modifier.padding(16.dp),
+ text = text,
+ style = textStyle.merge(paragraphStyle)
+ )
+ }
+}
+
+@Composable
+private fun BulletParagraph(
+ text: AnnotatedString,
+ textStyle: TextStyle,
+ paragraphStyle: ParagraphStyle
+) {
+ Row {
+ with(LocalDensity.current) {
+ // this box is acting as a character, so it's sized with font scaling (sp)
+ Box(
+ modifier = Modifier
+ .size(8.sp.toDp(), 8.sp.toDp())
+ .alignBy {
+ // Add an alignment "baseline" 1sp below the bottom of the circle
+ 9.sp.roundToPx()
+ }
+ .background(LocalContentColor.current, CircleShape),
+ ) { /* no content */ }
+ }
+ Text(
+ modifier = Modifier
+ .weight(1f)
+ .alignBy(FirstBaseline),
+ text = text,
+ style = textStyle.merge(paragraphStyle)
+ )
+ }
+}
+
+private data class ParagraphStyling(
+ val textStyle: TextStyle,
+ val paragraphStyle: ParagraphStyle,
+ val trailingPadding: Dp
+)
+
+@Composable
+private fun ParagraphType.getTextAndParagraphStyle(): ParagraphStyling {
+ val typography = MaterialTheme.typography
+ var textStyle: TextStyle = typography.bodyLarge
+ var paragraphStyle = ParagraphStyle()
+ var trailingPadding = 24.dp
+
+ when (this) {
+ ParagraphType.Caption -> textStyle = typography.bodyLarge
+ ParagraphType.Title -> textStyle = typography.headlineMedium
+ ParagraphType.Subhead -> {
+ textStyle = typography.titleLarge
+ trailingPadding = 16.dp
+ }
+ ParagraphType.Text -> {
+ textStyle = typography.bodyLarge.copy(lineHeight = 28.sp)
+ paragraphStyle = paragraphStyle.copy(lineHeight = 28.sp)
+ }
+ ParagraphType.Header -> {
+ textStyle = typography.headlineSmall
+ trailingPadding = 16.dp
+ }
+ ParagraphType.CodeBlock -> textStyle = typography.bodyLarge.copy(
+ fontFamily = FontFamily.Monospace
+ )
+ ParagraphType.Quote -> textStyle = typography.bodyLarge
+ ParagraphType.Bullet -> {
+ paragraphStyle = ParagraphStyle(textIndent = TextIndent(firstLine = 8.sp))
+ }
+ }
+ return ParagraphStyling(
+ textStyle,
+ paragraphStyle,
+ trailingPadding
+ )
+}
+
+private fun paragraphToAnnotatedString(
+ paragraph: Paragraph,
+ typography: Typography,
+ codeBlockBackground: Color
+): AnnotatedString {
+ val styles: List> = paragraph.markups
+ .map { it.toAnnotatedStringItem(typography, codeBlockBackground) }
+ return AnnotatedString(text = paragraph.text, spanStyles = styles)
+}
+
+fun Markup.toAnnotatedStringItem(
+ typography: Typography,
+ codeBlockBackground: Color
+): AnnotatedString.Range {
+ return when (this.type) {
+ MarkupType.Italic -> {
+ AnnotatedString.Range(
+ typography.bodyLarge.copy(fontStyle = FontStyle.Italic).toSpanStyle(),
+ start,
+ end
+ )
+ }
+ MarkupType.Link -> {
+ AnnotatedString.Range(
+ typography.bodyLarge.copy(textDecoration = TextDecoration.Underline).toSpanStyle(),
+ start,
+ end
+ )
+ }
+ MarkupType.Bold -> {
+ AnnotatedString.Range(
+ typography.bodyLarge.copy(fontWeight = FontWeight.Bold).toSpanStyle(),
+ start,
+ end
+ )
+ }
+ MarkupType.Code -> {
+ AnnotatedString.Range(
+ typography.bodyLarge
+ .copy(
+ background = codeBlockBackground,
+ fontFamily = FontFamily.Monospace
+ ).toSpanStyle(),
+ start,
+ end
+ )
+ }
+ }
+}
+
+private val ColorScheme.codeBlockBackground: Color
+ get() = onSurface.copy(alpha = .15f)
+
+@Preview("Post content")
+@Preview("Post content (dark)", uiMode = UI_MODE_NIGHT_YES)
+@Composable
+fun PreviewPost() {
+ JetnewsTheme {
+ Surface {
+ PostContent(post = post3)
+ }
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/components/InsetAwareTopAppBar.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/components/InsetAwareTopAppBar.kt
new file mode 100644
index 000000000..24c27928b
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/components/InsetAwareTopAppBar.kt
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.components
+
+import androidx.compose.foundation.layout.RowScope
+import androidx.compose.foundation.layout.statusBarsPadding
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.TopAppBar
+import androidx.compose.material3.TopAppBarDefaults
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.dp
+
+/**
+ * A wrapper around [TopAppBar] which uses [Modifier.statusBarsPadding] to shift the app bar's
+ * contents down, but still draws the background behind the status bar too.
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun InsetAwareTopAppBar(
+ title: @Composable () -> Unit,
+ modifier: Modifier = Modifier,
+ navigationIcon: @Composable (() -> Unit),
+ actions: @Composable RowScope.() -> Unit = {},
+ backgroundColor: Color = MaterialTheme.colorScheme.surface,
+ elevation: Dp = 4.dp
+) {
+ Surface(
+ color = backgroundColor,
+ shadowElevation = elevation,
+ tonalElevation = elevation,
+ modifier = modifier
+ ) {
+ TopAppBar(
+ title = title,
+ navigationIcon = navigationIcon,
+ actions = actions,
+ colors = TopAppBarDefaults.topAppBarColors().copy(
+ containerColor = Color.Transparent,
+ titleContentColor = MaterialTheme.colorScheme.onPrimary,
+ navigationIconContentColor = MaterialTheme.colorScheme.onPrimary
+ ),
+ modifier = Modifier.statusBarsPadding()
+ )
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/HomeScreen.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/HomeScreen.kt
new file mode 100644
index 000000000..6ac9a112b
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/HomeScreen.kt
@@ -0,0 +1,211 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.home
+
+import android.content.res.Configuration.UI_MODE_NIGHT_YES
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.PaddingValues
+import androidx.compose.foundation.layout.WindowInsets
+import androidx.compose.foundation.layout.WindowInsetsSides
+import androidx.compose.foundation.layout.add
+import androidx.compose.foundation.layout.asPaddingValues
+import androidx.compose.foundation.layout.only
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.systemBars
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.LazyRow
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material3.Divider
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.tooling.preview.Devices
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.dp
+import com.example.jetnews.R
+import com.example.jetnews.data.posts.PostsRepository
+import com.example.jetnews.model.Post
+import com.example.jetnews.ui.components.InsetAwareTopAppBar
+import com.example.jetnews.ui.theme.JetnewsTheme
+import kotlinx.coroutines.launch
+
+/**
+ * Stateful HomeScreen which manages state using [produceUiState]
+ *
+ * @param postsRepository data source for this screen
+ * @param navigateToArticle (event) request navigation to Article screen
+ * @param openDrawer (event) request opening the app drawer
+ */
+@Composable
+fun HomeScreen(
+ postsRepository: PostsRepository,
+ navigateToArticle: (String) -> Unit,
+ openDrawer: () -> Unit,
+) {
+ HomeScreen(
+ posts = postsRepository.getPosts(),
+ navigateToArticle = navigateToArticle,
+ openDrawer = openDrawer,
+ )
+}
+
+/**
+ * Responsible for displaying the Home Screen of this application.
+ *
+ * Stateless composable is not coupled to any specific state management.
+ *
+ * @param posts (state) the data to show on the screen
+ * @param favorites (state) favorite posts
+ * @param onToggleFavorite (event) toggles favorite for a post
+ * @param navigateToArticle (event) request navigation to Article screen
+ * @param openDrawer (event) request opening the app drawer
+ */
+@Composable
+fun HomeScreen(
+ posts: List,
+ navigateToArticle: (String) -> Unit,
+ openDrawer: () -> Unit,
+) {
+ val coroutineScope = rememberCoroutineScope()
+ Scaffold(
+ topBar = {
+ val title = stringResource(id = R.string.app_name)
+ InsetAwareTopAppBar(
+ title = { Text(text = title) },
+ navigationIcon = {
+ IconButton(onClick = { coroutineScope.launch { openDrawer() } }) {
+ Icon(
+ painter = painterResource(R.drawable.ic_jetnews_logo),
+ contentDescription = stringResource(R.string.cd_open_navigation_drawer)
+ )
+ }
+ }
+ )
+ }
+ ) { innerPadding ->
+ val modifier = Modifier.padding(innerPadding)
+ PostList(posts, navigateToArticle, modifier)
+ }
+}
+
+/**
+ * Display a list of posts.
+ *
+ * When a post is clicked on, [navigateToArticle] will be called to navigate to the detail screen
+ * for that post.
+ *
+ * @param posts (state) the list to display
+ * @param navigateToArticle (event) request navigation to Article screen
+ * @param modifier modifier for the root element
+ */
+@Composable
+private fun PostList(
+ posts: List,
+ navigateToArticle: (postId: String) -> Unit,
+ modifier: Modifier = Modifier
+) {
+ val postsHistory = posts.subList(0, 3)
+ val postsPopular = posts.subList(3, 5)
+ val contentPadding = rememberContentPaddingForScreen(additionalTop = 8.dp)
+
+ LazyColumn(
+ modifier = modifier,
+ contentPadding = contentPadding
+ ) {
+ items(postsHistory) { post ->
+ PostCardHistory(post, navigateToArticle)
+ PostListDivider()
+ }
+ item {
+ PostListPopularSection(postsPopular, navigateToArticle)
+ }
+ }
+}
+
+/**
+ * Horizontal scrolling cards for [PostList]
+ *
+ * @param posts (state) to display
+ * @param navigateToArticle (event) request navigation to Article screen
+ */
+@Composable
+private fun PostListPopularSection(
+ posts: List,
+ navigateToArticle: (String) -> Unit
+) {
+ Column {
+ Text(
+ modifier = Modifier.padding(16.dp),
+ text = stringResource(id = R.string.home_popular_section_title),
+ style = MaterialTheme.typography.titleMedium
+ )
+
+ LazyRow(contentPadding = PaddingValues(end = 16.dp)) {
+ items(posts) { post ->
+ PostCardPopular(
+ post,
+ navigateToArticle,
+ Modifier.padding(start = 16.dp, bottom = 16.dp)
+ )
+ }
+ }
+ PostListDivider()
+ }
+}
+
+/**
+ * Full-width divider with padding for [PostList]
+ */
+@Composable
+private fun PostListDivider() {
+ Divider(
+ modifier = Modifier.padding(horizontal = 14.dp),
+ color = MaterialTheme.colorScheme.onSurface.copy(alpha = 0.08f)
+ )
+}
+
+/**
+ * Determine the content padding to apply to the different screens of the app
+ */
+@Composable
+fun rememberContentPaddingForScreen(additionalTop: Dp = 0.dp) =
+ WindowInsets.systemBars
+ .only(WindowInsetsSides.Bottom)
+ .add(WindowInsets(top = additionalTop))
+ .asPaddingValues()
+@Preview("Home screen")
+@Preview("Home screen (dark)", uiMode = UI_MODE_NIGHT_YES)
+@Preview("Home screen (big font)", fontScale = 1.5f)
+@Preview("Home screen (large screen)", device = Devices.PIXEL_C)
+@Composable
+fun PreviewHomeScreen() {
+ JetnewsTheme {
+ HomeScreen(
+ posts = PostsRepository().getPosts(),
+ navigateToArticle = { /*TODO*/ },
+ openDrawer = { /*TODO*/ },
+ )
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/PostCards.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/PostCards.kt
new file mode 100644
index 000000000..520d25ddd
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/home/PostCards.kt
@@ -0,0 +1,234 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.home
+
+import android.content.res.Configuration
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.material3.AlertDialog
+import androidx.compose.material3.Card
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Close
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.LocalContentColor
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.layout.ContentScale
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.CustomAccessibilityAction
+import androidx.compose.ui.semantics.clearAndSetSemantics
+import androidx.compose.ui.semantics.customActions
+import androidx.compose.ui.semantics.onClick
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.text.style.TextOverflow
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import com.example.jetnews.R
+import com.example.jetnews.data.posts.impl.post1
+import com.example.jetnews.data.posts.impl.post3
+import com.example.jetnews.model.Post
+import com.example.jetnews.ui.theme.JetnewsTheme
+
+@Composable
+fun PostCardHistory(post: Post, navigateToArticle: (String) -> Unit) {
+ var openDialog by remember { mutableStateOf(false) }
+ // Step 3: Custom actions
+ val showFewerLabel = stringResource(R.string.cd_show_fewer)
+ Row(
+ // Step 2: Click labels
+ Modifier
+ .clickable(
+ // R.string.action_read_article = "read article"
+ onClickLabel = stringResource(R.string.action_read_article)
+ ) {
+ navigateToArticle(post.id)
+ }
+ // Step 3: Custom actions
+ .semantics {
+ customActions = listOf(
+ CustomAccessibilityAction(
+ label = showFewerLabel,
+ action = { openDialog = true; true }
+ )
+ )
+ }
+ ) {
+ Image(
+ painter = painterResource(post.imageThumbId),
+ contentDescription = null,
+ modifier = Modifier
+ .padding(top = 16.dp, start = 16.dp, end = 16.dp)
+ .size(40.dp, 40.dp)
+ .clip(MaterialTheme.shapes.small)
+ )
+ Column(
+ Modifier
+ .weight(1f)
+ .padding(top = 16.dp, bottom = 16.dp)
+ ) {
+ Text(post.title, style = MaterialTheme.typography.titleMedium)
+ Row(Modifier.padding(top = 4.dp)) {
+ CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurfaceVariant) {
+ val textStyle = MaterialTheme.typography.bodyMedium
+ Text(
+ text = post.metadata.author.name,
+ style = textStyle
+ )
+ Text(
+ text = " - ${post.metadata.readTimeMinutes} min read",
+ style = textStyle
+ )
+ }
+ }
+ }
+ CompositionLocalProvider(LocalContentColor provides MaterialTheme.colorScheme.onSurfaceVariant) {
+ // Step 1: Touch target size
+ IconButton(
+ // Step 3: Custom actions
+ modifier = Modifier.clearAndSetSemantics { },
+ onClick = { openDialog = true }
+ ) {
+ Icon(
+ imageVector = Icons.Default.Close,
+ contentDescription = showFewerLabel
+ )
+ }
+ }
+ }
+ if (openDialog) {
+ AlertDialog(
+ modifier = Modifier.padding(20.dp),
+ onDismissRequest = { openDialog = false },
+ title = {
+ Text(
+ text = stringResource(id = R.string.fewer_stories),
+ style = MaterialTheme.typography.titleLarge
+ )
+ },
+ text = {
+ Text(
+ text = stringResource(id = R.string.fewer_stories_content),
+ style = MaterialTheme.typography.bodyLarge
+ )
+ },
+ confirmButton = {
+ Text(
+ text = stringResource(id = R.string.agree),
+ style = MaterialTheme.typography.labelLarge,
+ color = MaterialTheme.colorScheme.primary,
+ modifier = Modifier
+ .padding(15.dp)
+ .clickable { openDialog = false }
+ )
+ }
+ )
+ }
+}
+
+@Composable
+fun PostCardPopular(
+ post: Post,
+ navigateToArticle: (String) -> Unit,
+ modifier: Modifier = Modifier
+) {
+ // Step 2: Click labels
+ val readArticleLabel = stringResource(id = R.string.action_read_article)
+ Card(
+ colors = CardDefaults.cardColors(),
+ shape = MaterialTheme.shapes.medium,
+ modifier = modifier
+ .size(280.dp, 240.dp)
+ .semantics { onClick(label = readArticleLabel, action = null) },
+ onClick = { navigateToArticle(post.id) },
+ elevation = CardDefaults.elevatedCardElevation()
+ ) {
+ Column {
+
+ Image(
+ painter = painterResource(post.imageId),
+ contentDescription = null, // decorative
+ contentScale = ContentScale.Crop,
+ modifier = Modifier
+ .height(100.dp)
+ .fillMaxWidth()
+ )
+
+ Column(modifier = Modifier.padding(16.dp)) {
+ Text(
+ text = post.title,
+ style = MaterialTheme.typography.titleLarge,
+ maxLines = 2,
+ overflow = TextOverflow.Ellipsis
+ )
+ Text(
+ text = post.metadata.author.name,
+ maxLines = 1,
+ overflow = TextOverflow.Ellipsis,
+ style = MaterialTheme.typography.bodyMedium
+ )
+
+ Text(
+ text = stringResource(
+ id = R.string.home_post_min_read,
+ post.metadata.date,
+ post.metadata.readTimeMinutes
+ ),
+ style = MaterialTheme.typography.bodyMedium
+ )
+ }
+ }
+ }
+}
+
+@Preview("Regular colors")
+@Preview("Dark colors", uiMode = Configuration.UI_MODE_NIGHT_YES)
+@Composable
+fun PreviewPostCardPopular() {
+ JetnewsTheme {
+ Surface {
+ PostCardPopular(post1, {})
+ }
+ }
+}
+
+@Preview("Post History card")
+@Composable
+fun HistoryPostPreview() {
+ JetnewsTheme {
+ Surface {
+ PostCardHistory(post3, {})
+ }
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/interests/InterestsScreen.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/interests/InterestsScreen.kt
new file mode 100644
index 000000000..2e5c454f1
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/interests/InterestsScreen.kt
@@ -0,0 +1,224 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.interests
+
+import android.annotation.SuppressLint
+import android.content.res.Configuration.UI_MODE_NIGHT_YES
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.foundation.selection.toggleable
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.material3.Checkbox
+import androidx.compose.material3.Divider
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.collectAsState
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.Role
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.semantics.stateDescription
+import androidx.compose.ui.tooling.preview.Devices
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import com.example.jetnews.R
+import com.example.jetnews.data.interests.InterestsRepository
+import com.example.jetnews.data.interests.TopicSelection
+import com.example.jetnews.data.interests.TopicsMap
+import com.example.jetnews.ui.components.InsetAwareTopAppBar
+import com.example.jetnews.ui.theme.JetnewsTheme
+import kotlinx.coroutines.launch
+
+/**
+ * Stateful InterestsScreen that handles the interaction with the repository
+ *
+ * @param interestsRepository data source for this screen
+ * @param openDrawer (event) request opening the app drawer
+ */
+@Composable
+fun InterestsScreen(
+ interestsRepository: InterestsRepository,
+ openDrawer: () -> Unit,
+ modifier: Modifier = Modifier,
+) {
+ // Returns a [CoroutineScope] that is scoped to the lifecycle of [InterestsScreen]. When this
+ // screen is removed from composition, the scope will be cancelled.
+ val coroutineScope = rememberCoroutineScope()
+
+ // collectAsState will read a [Flow] in Compose
+ val selectedTopics by interestsRepository.observeTopicsSelected().collectAsState(setOf())
+ val onTopicSelect: (TopicSelection) -> Unit = {
+ coroutineScope.launch { interestsRepository.toggleTopicSelection(it) }
+ }
+ InterestsScreen(
+ topics = interestsRepository.topics,
+ selectedTopics = selectedTopics,
+ onTopicSelect = onTopicSelect,
+ openDrawer = openDrawer,
+ modifier = modifier,
+ )
+}
+
+/**
+ * Stateless interest screen displays the topics the user can subscribe to
+ *
+ * @param topics (state) topics to display, mapped by section
+ * @param selectedTopics (state) currently selected topics
+ * @param onTopicSelect (event) request a topic selection be changed
+ * @param openDrawer (event) request opening the app drawer
+ */
+@Composable
+fun InterestsScreen(
+ topics: TopicsMap,
+ selectedTopics: Set,
+ onTopicSelect: (TopicSelection) -> Unit,
+ openDrawer: () -> Unit,
+ modifier: Modifier = Modifier
+) {
+ Scaffold(
+ topBar = {
+ InsetAwareTopAppBar(
+ title = { Text("Interests") },
+ navigationIcon = {
+ IconButton(onClick = openDrawer) {
+ Icon(
+ painter = painterResource(R.drawable.ic_jetnews_logo),
+ contentDescription = stringResource(R.string.cd_open_navigation_drawer)
+ )
+ }
+ }
+ )
+ }
+ ) { padding ->
+ LazyColumn(
+ modifier = modifier.padding(padding)
+ ) {
+ topics.forEach { (section, topics) ->
+ item {
+ Text(
+ text = section,
+ modifier = Modifier
+ .padding(16.dp),
+ style = MaterialTheme.typography.titleMedium
+ )
+ }
+ items(topics) { topic ->
+ TopicItem(
+ itemTitle = topic,
+ selected = selectedTopics.contains(TopicSelection(section, topic))
+ ) { onTopicSelect(TopicSelection(section, topic)) }
+ TopicDivider()
+ }
+ }
+ }
+ }
+}
+
+/**
+ * Display a full-width topic item
+ *
+ * @param itemTitle (state) topic title
+ * @param selected (state) is topic currently selected
+ * @param onToggle (event) toggle selection for topic
+ */
+@Composable
+private fun TopicItem(itemTitle: String, selected: Boolean, onToggle: () -> Unit) {
+ val image = painterResource(R.drawable.placeholder_1_1)
+ // Step 8: State descriptions
+ val stateNotSubscribed = stringResource(R.string.state_not_subscribed)
+ val stateSubscribed = stringResource(R.string.state_subscribed)
+ Row(
+ modifier = Modifier
+ // Step 8: State descriptions
+ .semantics {
+ stateDescription = if (selected) {
+ stateSubscribed
+ } else {
+ stateNotSubscribed
+ }
+ }
+ // Step 7: Switches and Checkboxes
+ .toggleable(
+ value = selected,
+ onValueChange = { _ -> onToggle() },
+ role = Role.Checkbox
+ )
+ .padding(horizontal = 16.dp, vertical = 8.dp)
+ ) {
+ Image(
+ painter = image,
+ contentDescription = null,
+ modifier = Modifier
+ .align(Alignment.CenterVertically)
+ .size(56.dp, 56.dp)
+ .clip(RoundedCornerShape(4.dp))
+ )
+ Text(
+ text = itemTitle,
+ modifier = Modifier
+ .align(Alignment.CenterVertically)
+ .padding(16.dp),
+ style = MaterialTheme.typography.titleMedium
+ )
+ Spacer(Modifier.weight(1f))
+ Checkbox(
+ checked = selected,
+ // Step 7: Switches and Checkboxes
+ onCheckedChange = null,
+ modifier = Modifier.align(Alignment.CenterVertically)
+ )
+ }
+}
+
+/**
+ * Full-width divider for topics
+ */
+@Composable
+private fun TopicDivider() {
+ Divider(
+ modifier = Modifier.padding(start = 90.dp),
+ color = MaterialTheme.colorScheme.onSurface.copy(alpha = 0.1f)
+ )
+}
+
+@Preview("Interests screen", "Interests")
+@Preview("Interests screen (dark)", "Interests", uiMode = UI_MODE_NIGHT_YES)
+@Preview("Interests screen (big font)", "Interests", fontScale = 1.5f)
+@Preview("Interests screen (large screen)", "Interests", device = Devices.PIXEL_C)
+@Composable
+fun PreviewInterestsScreen() {
+ JetnewsTheme {
+ InterestsScreen(
+ interestsRepository = InterestsRepository(),
+ openDrawer = {}
+ )
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Color.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Color.kt
new file mode 100644
index 000000000..34825b8b9
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Color.kt
@@ -0,0 +1,27 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.theme
+
+import androidx.compose.ui.graphics.Color
+
+val Red200 = Color(0xfff297a2)
+val Red300 = Color(0xffea6d7e)
+val Red700 = Color(0xffdd0d3c)
+val Red800 = Color(0xffd00036)
+val Red900 = Color(0xffc20029)
+
+val DarkGray200 = Color(0xFF2A2A2A)
\ No newline at end of file
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Shape.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Shape.kt
new file mode 100644
index 000000000..10c00e956
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Shape.kt
@@ -0,0 +1,27 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.theme
+
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.material3.Shapes
+import androidx.compose.ui.unit.dp
+
+val JetnewsShapes = Shapes(
+ small = RoundedCornerShape(4.dp),
+ medium = RoundedCornerShape(4.dp),
+ large = RoundedCornerShape(8.dp)
+)
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Theme.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Theme.kt
new file mode 100644
index 000000000..7391789f9
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Theme.kt
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.theme
+
+import androidx.compose.foundation.isSystemInDarkTheme
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.darkColorScheme
+import androidx.compose.material3.lightColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.graphics.Color
+
+private val LightThemeColors = lightColorScheme(
+ primary = Red700,
+ primaryContainer = Red900,
+ surface = Red700,
+ onPrimary = Color.White,
+ secondary = Red700,
+ secondaryContainer = Red900,
+ onSecondary = Color.White,
+ error = Red800
+)
+
+private val DarkThemeColors = darkColorScheme(
+ primary = Red300,
+ primaryContainer = Red700,
+ surface = DarkGray200,
+ onPrimary = Color.White,
+ secondary = Red300,
+ onSecondary = Color.Black,
+ error = Red200
+)
+
+@Composable
+fun JetnewsTheme(
+ darkTheme: Boolean = isSystemInDarkTheme(),
+ content: @Composable () -> Unit
+) {
+ MaterialTheme(
+ colorScheme = if (darkTheme) DarkThemeColors else LightThemeColors,
+ typography = JetnewsTypography,
+ shapes = JetnewsShapes,
+ content = content
+ )
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Type.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Type.kt
new file mode 100644
index 000000000..155788514
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/ui/theme/Type.kt
@@ -0,0 +1,99 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.ui.theme
+
+import androidx.compose.material3.Typography
+import androidx.compose.ui.text.TextStyle
+import androidx.compose.ui.text.font.Font
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.sp
+import com.example.jetnews.R
+
+private val Montserrat = FontFamily(
+ Font(R.font.montserrat_regular),
+ Font(R.font.montserrat_medium, FontWeight.W500),
+ Font(R.font.montserrat_semibold, FontWeight.W600)
+)
+
+private val Domine = FontFamily(
+ Font(R.font.domine_regular),
+ Font(R.font.domine_bold, FontWeight.Bold)
+)
+
+val JetnewsTypography = Typography(
+ headlineMedium = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 30.sp,
+ letterSpacing = 0.sp
+ ),
+ headlineSmall = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 24.sp,
+ letterSpacing = 0.sp
+ ),
+ titleLarge = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 20.sp,
+ letterSpacing = 0.sp
+ ),
+ titleMedium = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 16.sp,
+ letterSpacing = 0.15.sp
+ ),
+ titleSmall = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.Medium,
+ fontSize = 14.sp,
+ letterSpacing = 0.1.sp
+ ),
+ bodyLarge = TextStyle(
+ fontFamily = Domine,
+ fontWeight = FontWeight.Normal,
+ fontSize = 16.sp,
+ letterSpacing = 0.5.sp
+ ),
+ bodyMedium = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.Medium,
+ fontSize = 14.sp,
+ letterSpacing = 0.25.sp
+ ),
+ labelLarge = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 14.sp,
+ letterSpacing = 1.25.sp
+ ),
+ bodySmall = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.Medium,
+ fontSize = 12.sp,
+ letterSpacing = 0.4.sp
+ ),
+ labelSmall = TextStyle(
+ fontFamily = Montserrat,
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 12.sp,
+ letterSpacing = 1.sp
+ )
+)
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/MapExtensions.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/MapExtensions.kt
new file mode 100644
index 000000000..7c8608e19
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/MapExtensions.kt
@@ -0,0 +1,23 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.utils
+
+internal fun MutableSet.addOrRemove(element: E) {
+ if (!add(element)) {
+ remove(element)
+ }
+}
diff --git a/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/Modifiers.kt b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/Modifiers.kt
new file mode 100644
index 000000000..248f6f52b
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/java/com/example/jetnews/utils/Modifiers.kt
@@ -0,0 +1,32 @@
+/*
+ * Copyright 2021 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.jetnews.utils
+
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.widthIn
+import androidx.compose.foundation.layout.wrapContentWidth
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+
+/**
+ * Support wide screen by making the content width max 840dp, centered horizontally.
+ */
+fun Modifier.supportWideScreen() = this
+ .fillMaxWidth()
+ .wrapContentWidth(align = Alignment.CenterHorizontally)
+ .widthIn(max = 840.dp)
diff --git a/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_background.xml b/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_background.xml
new file mode 100644
index 000000000..899bbb7e1
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_background.xml
@@ -0,0 +1,55 @@
+
+
+
+
+
+
+
+
+
+
+
diff --git a/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_foreground.xml b/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_foreground.xml
new file mode 100644
index 000000000..10fc024e4
--- /dev/null
+++ b/AccessibilityCodelab/app/src/main/res/drawable-anydpi-v26/ic_launcher_foreground.xml
@@ -0,0 +1,87 @@
+
+
+
+
+
+
+
Apple trees are large if grown from seed. Generally apple cultivars are propagated by grafting onto rootstocks, which control the size of the resulting tree. There are more than 7,500 known cultivars of apples, resulting in a range of desired characteristics. Different cultivars are bred for various tastes and uses, including cooking, eating raw and cider production. Trees and fruit are prone to a number of fungal, bacterial and pest problems, which can be controlled by a number of organic and non-organic means. In 2010, the fruit's genome was sequenced as part of research on disease control and selective breeding in apple production.
Worldwide production of apples in 2014 was 84.6 million tonnes, with China accounting for 48% of the total.
(From Wikipedia)",
+ "growZoneNumber": 3,
+ "wateringInterval": 30,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/5/55/Apple_orchard_in_Tasmania.jpg"
+ },
+ {
+ "plantId": "beta-vulgaris",
+ "name": "Beet",
+ "description": "The beetroot is the taproot portion of the beet plant, usually known in North America as the beet and also known as the table beet, garden beet, red beet, or golden beet. It is one of several of the cultivated varieties of Beta vulgaris grown for their edible taproots and their leaves (called beet greens). These varieties have been classified as B. vulgaris subsp. vulgaris Conditiva Group.
Other than as a food, beets have use as a food colouring and as a medicinal plant. Many beet products are made from other Beta vulgaris varieties, particularly sugar beet.
(From Wikipedia)",
+ "growZoneNumber": 2,
+ "wateringInterval": 7,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/2/29/Beetroot_jm26647.jpg"
+ },
+ {
+ "plantId": "coriandrum-sativum",
+ "name": "Cilantro",
+ "description": "Coriander, also known as cilantro or Chinese parsley, is an annual herb in the family Apiaceae. All parts of the plant are edible, but the fresh leaves and the dried seeds are the parts most traditionally used in cooking.
(From Wikipedia)",
+ "growZoneNumber": 2,
+ "wateringInterval": 2,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/5/51/A_scene_of_Coriander_leaves.JPG"
+ },
+ {
+ "plantId": "solanum-lycopersicum",
+ "name": "Tomato",
+ "description": "The tomato is the edible, often red, berry of the nightshade Solanum lycopersicum, commonly known as a tomato plant. The species originated in western South America. The Nahuatl (Aztec language) word tomatl gave rise to the Spanish word tomate, from which the English word tomato derived. Its use as a cultivated food may have originated with the indigenous peoples of Mexico. The Spanish encountered the tomato from their contact with the Aztec during the Spanish colonization of the Americas and brought it to Europe. From there, the tomato was introduced to other parts of the European-colonized world during the 16th century.
The tomato is consumed in diverse ways, raw or cooked, in many dishes, sauces, salads, and drinks. While tomatoes are fruits – botanically classified as berries – they are commonly used as a vegetable ingredient or side dish.
Numerous varieties of the tomato plant are widely grown in temperate climates across the world, with greenhouses allowing for the production of tomatoes throughout all seasons of the year. Tomato plants typically grow to 1–3 meters (3–10 ft) in height. They are vines that have a weak stem that sprawls and typically needs support. Indeterminate tomato plants are perennials in their native habitat, but are cultivated as annuals. Determinate, or bush, plants are annuals that stop growing at a certain height and produce a crop all at once. The size of the tomato varies according to the cultivar, with a range of 0.5–4 inches (1.3–10.2 cm) in width.
(From Wikipedia)",
+ "growZoneNumber": 9,
+ "wateringInterval": 4,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/1/17/Cherry_tomatoes_red_and_green_2009_16x9.jpg"
+ },
+ {
+ "plantId": "persea-americana",
+ "name": "Avocado",
+ "description": "The avocado (Persea americana) is a tree, long thought to have originated in South Central Mexico, classified as a member of the flowering plant family Lauraceae. The fruit of the plant, also called an avocado (or avocado pear or alligator pear), is botanically a large berry containing a single large seed.
Avocados are commercially valuable and are cultivated in tropical and Mediterranean climates throughout the world. They have a green-skinned, fleshy body that may be pear-shaped, egg-shaped, or spherical. Commercially, they ripen after harvesting. Avocado trees are partially self-pollinating and are often propagated through grafting to maintain a predictable quality and quantity of the fruit.
(From Wikipedia)",
+ "growZoneNumber": 9,
+ "wateringInterval": 3,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/e/e4/Branch_and_fruit_of_the_Maluma_avocado_cultivar.jpg"
+ },
+ {
+ "plantId": "pyrus-communis",
+ "name": "Pear",
+ "description": "The pear tree and shrub are a species of genus Pyrus, in the family Rosaceae, bearing the pomaceous fruit of the same name. Several species of pear are valued for their edible fruit and juices while others are cultivated as trees.
(From Wikipedia)",
+ "growZoneNumber": 3,
+ "wateringInterval": 30,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/1/13/More_pears.jpg"
+ },
+ {
+ "plantId": "solanum-melongena",
+ "name": "Eggplant",
+ "description": "Eggplant (US), aubergine (UK), or brinjal (South Asia and South Africa) is a plant species in the nightshade family Solanaceae, Solanum melongena, grown for its often purple edible fruit.
The spongy, absorbent fruit of the plant is widely used in cooking in many different cuisines, and is often considered a vegetable, even though it is a berry by botanical definition. As a member of the genus Solanum, it is related to the tomato and the potato. Like the tomato, its skin and seeds can be eaten, but, like the potato, it is not advisable to eat it raw. Eggplant supplies low contents of macronutrients and micronutrients. The capability of the fruit to absorb oils and flavors into its flesh through cooking is well known in the culinary arts.
It was originally domesticated from the wild nightshade species thorn or bitter apple, S. incanum, probably with two independent domestications: one in South Asia, and one in East Asia.
(From Wikipedia)",
+ "growZoneNumber": 4,
+ "wateringInterval": 3,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/e/e5/Eggplant_display.JPG"
+ },
+ {
+ "plantId": "vitis-vinifera",
+ "name": "Grape",
+ "description": "A grape is a fruit, botanically a berry, of the deciduous woody vines of the flowering plant genus Vitis.
Grapes can be eaten fresh as table grapes or they can be used for making wine, jam, juice, jelly, grape seed extract, raisins, vinegar, and grape seed oil. Grapes are a non-climacteric type of fruit, generally occurring in clusters.
(From Wikipedia)",
+ "growZoneNumber": 9,
+ "wateringInterval": 9,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/0/03/Grape_Plant_and_grapes9.jpg"
+ },
+ {
+ "plantId": "mangifera-indica",
+ "name": "Mango",
+ "description": "Mangoes are juicy stone fruit (drupe) from numerous species of tropical trees belonging to the flowering plant genus Mangifera, cultivated mostly for their edible fruit.
The majority of these species are found in nature as wild mangoes. The genus belongs to the cashew family Anacardiaceae. Mangoes are native to South Asia, from where the 'common mango' or 'Indian mango', Mangifera indica, has been distributed worldwide to become one of the most widely cultivated fruits in the tropics. Other Mangifera species (e.g. horse mango, Mangifera foetida) are grown on a more localized basis.
It is the national fruit of India, Pakistan, and the Philippines, and the national tree of Bangladesh.
(From Wikipedia)",
+ "growZoneNumber": 11,
+ "wateringInterval": 7,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/6/67/Mangos_criollos_y_pera.JPG"
+ },
+ {
+ "plantId": "citrus-x-sinensis",
+ "name": "Orange",
+ "description": "The orange is the fruit of the citrus species Citrus × sinensis in the family Rutaceae. It is also called sweet orange, to distinguish it from the related Citrus × aurantium, referred to as bitter orange. The sweet orange reproduces asexually (apomixis through nucellar embryony); varieties of sweet orange arise through mutations.
The orange is a hybrid between pomelo (Citrus maxima) and mandarin (Citrus reticulata). The chloroplast genome, and therefore the maternal line, is that of pomelo. The sweet orange has had its full genome sequenced.
Sweet oranges were mentioned in Chinese literature in 314 BC. As of 1987, orange trees were found to be the most cultivated fruit tree in the world. Orange trees are widely grown in tropical and subtropical climates for their sweet fruit. The fruit of the orange tree can be eaten fresh, or processed for its juice or fragrant peel. As of 2012, sweet oranges accounted for approximately 70% of citrus production.
In 2014, 70.9 million tonnes of oranges were grown worldwide, with Brazil producing 24% of the world total followed by China and India.
(From Wikipedia)",
+ "growZoneNumber": 9,
+ "wateringInterval": 30,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/2/22/Apfelsinenbaum--Orange_tree.jpg"
+ },
+ {
+ "plantId": "helianthus-annuus",
+ "name": "Sunflower",
+ "description": "Roses are red
Violets are blue
Sunflowers have seeds
That folks love to chew
- M.G., 2018
Helianthus annuus, the common sunflower, is a large annual forb of the genus Helianthus grown as a crop for its edible oil and edible fruits. This sunflower species is also used as wild bird food, as livestock forage (as a meal or a silage plant), in some industrial applications, and as an ornamental in domestic gardens. The plant was first domesticated in the Americas. Wild Helianthus annuus is a widely branched annual plant with many flower heads. The domestic sunflower, however, often possesses only a single large inflorescence (flower head) atop an unbranched stem. The name sunflower may derive from the flower's head's shape, which resembles the sun, or from the impression that the blooming plant appears to slowly turn its flower towards the sun as the latter moves across the sky on a daily basis.
Sunflower seeds were brought to Europe from the Americas in the 16th century, where, along with sunflower oil, they became a widespread cooking ingredient.
(From Wikipedia)",
+ "growZoneNumber": 8,
+ "wateringInterval": 3,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/a/aa/Sunflowers_in_field_flower.jpg"
+ },
+ {
+ "plantId": "citrullus-lanatus",
+ "name": "Watermelon",
+ "description": "Citrullus lanatus is a plant species in the family Cucurbitaceae, a vine-like (scrambler and trailer) flowering plant originating in West Africa. It is cultivated for its fruit. The subdivision of this species into two varieties, watermelons (Citrullus lanatus (Thunb.) var. lanatus) and citron melons (Citrullus lanatus var. citroides (L. H. Bailey) Mansf.), originated with the erroneous synonymization of Citrullus lanatus (Thunb.) Matsum. & Nakai and Citrullus vulgaris Schrad. by L.H. Bailey in 1930. Molecular data including sequences from the original collection of Thunberg and other relevant type material, show that the sweet watermelon (Citrullus vulgaris Schrad.) and the bitter wooly melon Citrullus lanatus (Thunb.) Matsum. & Nakai are not closely related to each other. Since 1930, thousands of papers have misapplied the name Citrullus lanatus (Thunb.) Matsum. & Nakai for the watermelon, and a proposal to conserve the name with this meaning was accepted by the relevant nomenclatural committee and confirmed at the International Botanical Congress in Shenzhen.
The bitter South African melon first collected by Thunberg has become naturalized in semiarid regions of several continents, and is designated as a 'pest plant' in parts of Western Australia where they are called pig melon.
Watermelon (Citrullus lanatus) is a scrambling and trailing vine in the flowering plant family Cucurbitaceae. The species was long thought to have originated in southern Africa, but this was based on the erroneous synonymization by L. H. Bailey (1930) of a South African species with the cultivated watermelon. The error became apparent with DNA comparison of material of the cultivated watermelon seen and named by Linnaeus and the holotype of the South African species. There is evidence from seeds in Pharao tombs of watermelon cultivation in Ancient Egypt. Watermelon is grown in tropical and subtropical areas worldwide for its large edible fruit, also known as a watermelon, which is a special kind of berry with a hard rind and no internal division, botanically called a pepo. The sweet, juicy flesh is usually deep red to pink, with many black seeds, although seedless varieties have been cultivated. The fruit can be eaten raw or pickled and the rind is edible after cooking.
Considerable breeding effort has been put into disease-resistant varieties. Many cultivars are available that produce mature fruit within 100 days of planting the crop.
(From Wikipedia)",
+ "growZoneNumber": 7,
+ "wateringInterval": 3,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/f/fc/01266jfWatermelons_Philippines_textures_Apolonio_Samson_Market_Quezon_Cityfvf_02.jpg"
+ },
+ {
+ "plantId": "hibiscus-rosa-sinensis",
+ "name": "Hibiscus",
+ "description": "Hibiscus is a genus of flowering plants in the mallow family, Malvaceae. The genus is quite large, comprising several hundred species that are native to warm temperate, subtropical and tropical regions throughout the world. Member species are renowned for their large, showy flowers and those species are commonly known simply as 'hibiscus', or less widely known as rose mallow. There are also names for hibiscus such as hardy hibiscus, rose of sharon, and tropical hibiscus.
The genus includes both annual and perennial herbaceous plants, as well as woody shrubs and small trees. The generic name is derived from the Greek name ἰβίσκος (hibiskos) which Pedanius Dioscorides gave to Althaea officinalis (c. 40–90 AD).
Several species are widely cultivated as ornamental plants, notably Hibiscus syriacus and Hibiscus rosa-sinensis.
A tea made from hibiscus flowers is known by many names around the world and is served both hot and cold. The beverage is known for its red colour, tart flavour, and vitamin C content.
(From Wikipedia)",
+ "growZoneNumber": 10,
+ "wateringInterval": 1,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/8/82/Hibiscus_rosa-sinensis_flower_2.JPG"
+ },
+ {
+ "plantId": "cypripedium-reginae",
+ "name": "Pink & White Lady's Slipper",
+ "description": "Cypripedium reginae, known as the showy lady's slipper, pink-and-white lady's-slipper, or the queen's lady's-slipper, is a rare terrestrial lady's-slipper orchid native to northern North America.
It is the state flower of Minnesota, United States, and the provincial flower of Prince Edward Island, Canada.
Despite producing a large amount of seeds per seed pod, it reproduces largely by vegetative reproduction, and remains restricted to the North East region of the United States and south east regions of Canada. Although never common, this rare plant has vanished from much of its historical range due to habitat loss. It has been a subject of horticultural interest for many years with Charles Darwin who, like many, was unsuccessful in cultivating the plant.
(From Wikipedia)",
+ "growZoneNumber": 4,
+ "wateringInterval": 7,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/a/ab/Cypripedium_reginae_Orchi_004.jpg"
+ },
+ {
+ "plantId": "aquilegia-coerulea",
+ "name": "Rocky Mountain Columbine",
+ "description": "Aquilegia coerulea, the state flower of Colorado, is a species of flowering plant in the buttercup family Ranunculaceae, native to the Rocky Mountains from Montana south to New Mexico and west to Idaho and Arizona. Its common name is Colorado blue columbine; sometimes it is called \"Rocky Mountain columbine,\" but this also refers to Aquilegia saximontana.
(From Wikipedia)",
+ "growZoneNumber": 5,
+ "wateringInterval": 3,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/9/94/Aquilegia_caerulea.jpg"
+ },
+ {
+ "plantId": "magnolia-denudata",
+ "name": "Yulan Magnolia",
+ "description": "Magnolia denudata, known as the lilytree or Yulan magnolia (simplified Chinese: 玉兰花; traditional Chinese: 玉蘭花), is native to central and eastern China. It has been cultivated in Chinese Buddhist temple gardens since 600 AD. Its flowers were regarded as a symbol of purity in the Tang Dynasty and it was planted in the grounds of the Emperor's palace.
It is the official city flower of Shanghai.
(From Wikipedia)",
+ "growZoneNumber": 8,
+ "wateringInterval": 7,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/1/13/Yulan_magnolia_%28Magnolia_denudata%29_%2816953983745%29.jpg"
+ },
+ {
+ "plantId": "bougainvillea-glabra",
+ "name": "Bougainvillea",
+ "description": "Bougainvillea is a genus of thorny ornamental vines, bushes, or trees. The inflorescence consists of large colourful sepallike bracts which surround three simple waxy flowers. The vine species grow anywhere from 1 to 12 m (3 to 40 ft.) tall, scrambling over other plants with their spiky thorns, which are tipped with a black, waxy substance. They are evergreen where rainfall occurs all year, or deciduous if there is a dry season.
Bougainvillea glabra (simplified Chinese: 簕杜鹃; traditional Chinese: 簕杜鵑) is the official city flower of Shenzhen and many other cities around the world.
(From Wikipedia)",
+ "growZoneNumber": 10,
+ "wateringInterval": 21,
+ "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/6/6d/Paperflower_--_Bougainvillea_glabra.jpg"
+ }
+]
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenActivity.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenActivity.kt
new file mode 100644
index 000000000..37fa29a5a
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenActivity.kt
@@ -0,0 +1,35 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower
+
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import androidx.core.view.WindowCompat
+import androidx.databinding.DataBindingUtil.setContentView
+import com.google.samples.apps.sunflower.databinding.ActivityGardenBinding
+
+class GardenActivity : AppCompatActivity() {
+
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+
+ // Displaying edge-to-edge
+ WindowCompat.setDecorFitsSystemWindows(window, false)
+
+ setContentView(this, R.layout.activity_garden)
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenFragment.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenFragment.kt
new file mode 100644
index 000000000..2b1197016
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/GardenFragment.kt
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.viewModels
+import androidx.viewpager2.widget.ViewPager2
+import com.google.samples.apps.sunflower.adapters.GardenPlantingAdapter
+import com.google.samples.apps.sunflower.adapters.PLANT_LIST_PAGE_INDEX
+import com.google.samples.apps.sunflower.databinding.FragmentGardenBinding
+import com.google.samples.apps.sunflower.utilities.InjectorUtils
+import com.google.samples.apps.sunflower.viewmodels.GardenPlantingListViewModel
+
+class GardenFragment : Fragment() {
+
+ private lateinit var binding: FragmentGardenBinding
+
+ private val viewModel: GardenPlantingListViewModel by viewModels {
+ InjectorUtils.provideGardenPlantingListViewModelFactory(requireContext())
+ }
+
+ override fun onCreateView(
+ inflater: LayoutInflater,
+ container: ViewGroup?,
+ savedInstanceState: Bundle?
+ ): View? {
+ binding = FragmentGardenBinding.inflate(inflater, container, false)
+ val adapter = GardenPlantingAdapter()
+ binding.gardenList.adapter = adapter
+
+ binding.addPlant.setOnClickListener {
+ navigateToPlantListPage()
+ }
+
+ subscribeUi(adapter, binding)
+ return binding.root
+ }
+
+ private fun subscribeUi(adapter: GardenPlantingAdapter, binding: FragmentGardenBinding) {
+ viewModel.plantAndGardenPlantings.observe(viewLifecycleOwner) { result ->
+ binding.hasPlantings = !result.isNullOrEmpty()
+ adapter.submitList(result)
+ }
+ }
+
+ // TODO: convert to data binding if applicable
+ private fun navigateToPlantListPage() {
+ requireActivity().findViewById(R.id.view_pager).currentItem =
+ PLANT_LIST_PAGE_INDEX
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/HomeViewPagerFragment.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/HomeViewPagerFragment.kt
new file mode 100644
index 000000000..76c0c1cb6
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/HomeViewPagerFragment.kt
@@ -0,0 +1,70 @@
+/*
+ * Copyright 2019 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.appcompat.app.AppCompatActivity
+import androidx.fragment.app.Fragment
+import com.google.android.material.tabs.TabLayoutMediator
+import com.google.samples.apps.sunflower.adapters.MY_GARDEN_PAGE_INDEX
+import com.google.samples.apps.sunflower.adapters.PLANT_LIST_PAGE_INDEX
+import com.google.samples.apps.sunflower.adapters.SunflowerPagerAdapter
+import com.google.samples.apps.sunflower.databinding.FragmentViewPagerBinding
+
+class HomeViewPagerFragment : Fragment() {
+
+ override fun onCreateView(
+ inflater: LayoutInflater,
+ container: ViewGroup?,
+ savedInstanceState: Bundle?
+ ): View? {
+ val binding = FragmentViewPagerBinding.inflate(inflater, container, false)
+ val tabLayout = binding.tabs
+ val viewPager = binding.viewPager
+
+ viewPager.adapter = SunflowerPagerAdapter(this)
+
+ // Set the icon and text for each tab
+ TabLayoutMediator(tabLayout, viewPager) { tab, position ->
+ tab.setIcon(getTabIcon(position))
+ tab.text = getTabTitle(position)
+ }.attach()
+
+ (activity as AppCompatActivity).setSupportActionBar(binding.toolbar)
+
+ return binding.root
+ }
+
+ private fun getTabIcon(position: Int): Int {
+ return when (position) {
+ MY_GARDEN_PAGE_INDEX -> R.drawable.garden_tab_selector
+ PLANT_LIST_PAGE_INDEX -> R.drawable.plant_list_tab_selector
+ else -> throw IndexOutOfBoundsException()
+ }
+ }
+
+ private fun getTabTitle(position: Int): String? {
+ return when (position) {
+ MY_GARDEN_PAGE_INDEX -> getString(R.string.my_garden_title)
+ PLANT_LIST_PAGE_INDEX -> getString(R.string.plant_list_title)
+ else -> null
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/PlantListFragment.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/PlantListFragment.kt
new file mode 100644
index 000000000..89b9adb42
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/PlantListFragment.kt
@@ -0,0 +1,84 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.Menu
+import android.view.MenuInflater
+import android.view.MenuItem
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.viewModels
+import com.google.samples.apps.sunflower.adapters.PlantAdapter
+import com.google.samples.apps.sunflower.databinding.FragmentPlantListBinding
+import com.google.samples.apps.sunflower.utilities.InjectorUtils
+import com.google.samples.apps.sunflower.viewmodels.PlantListViewModel
+
+class PlantListFragment : Fragment() {
+
+ private val viewModel: PlantListViewModel by viewModels {
+ InjectorUtils.providePlantListViewModelFactory(this)
+ }
+
+ override fun onCreateView(
+ inflater: LayoutInflater,
+ container: ViewGroup?,
+ savedInstanceState: Bundle?
+ ): View? {
+ val binding = FragmentPlantListBinding.inflate(inflater, container, false)
+ context ?: return binding.root
+
+ val adapter = PlantAdapter()
+ binding.plantList.adapter = adapter
+ subscribeUi(adapter)
+
+ setHasOptionsMenu(true)
+ return binding.root
+ }
+
+ override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
+ inflater.inflate(R.menu.menu_plant_list, menu)
+ }
+
+ override fun onOptionsItemSelected(item: MenuItem): Boolean {
+ return when (item.itemId) {
+ R.id.filter_zone -> {
+ updateData()
+ true
+ }
+ else -> super.onOptionsItemSelected(item)
+ }
+ }
+
+ private fun subscribeUi(adapter: PlantAdapter) {
+ viewModel.plants.observe(viewLifecycleOwner) { plants ->
+ adapter.submitList(plants)
+ }
+ }
+
+ private fun updateData() {
+ with(viewModel) {
+ if (isFiltered()) {
+ clearGrowZoneNumber()
+ } else {
+ setGrowZoneNumber(9)
+ }
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/BindIsGone.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/BindIsGone.kt
new file mode 100644
index 000000000..7cc6703dd
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/BindIsGone.kt
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.adapters
+
+import android.view.View
+import androidx.databinding.BindingAdapter
+
+@BindingAdapter("isGone")
+fun bindIsGone(view: View, isGone: Boolean) {
+ view.visibility = if (isGone) {
+ View.GONE
+ } else {
+ View.VISIBLE
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/GardenPlantingAdapter.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/GardenPlantingAdapter.kt
new file mode 100644
index 000000000..e697df8d4
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/GardenPlantingAdapter.kt
@@ -0,0 +1,94 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.adapters
+
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.databinding.DataBindingUtil
+import androidx.navigation.findNavController
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import com.google.samples.apps.sunflower.HomeViewPagerFragmentDirections
+import com.google.samples.apps.sunflower.R
+import com.google.samples.apps.sunflower.data.PlantAndGardenPlantings
+import com.google.samples.apps.sunflower.databinding.ListItemGardenPlantingBinding
+import com.google.samples.apps.sunflower.viewmodels.PlantAndGardenPlantingsViewModel
+
+class GardenPlantingAdapter :
+ ListAdapter(
+ GardenPlantDiffCallback()
+ ) {
+
+ override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
+ return ViewHolder(
+ DataBindingUtil.inflate(
+ LayoutInflater.from(parent.context),
+ R.layout.list_item_garden_planting,
+ parent,
+ false
+ )
+ )
+ }
+
+ override fun onBindViewHolder(holder: ViewHolder, position: Int) {
+ holder.bind(getItem(position))
+ }
+
+ class ViewHolder(
+ private val binding: ListItemGardenPlantingBinding
+ ) : RecyclerView.ViewHolder(binding.root) {
+ init {
+ binding.setClickListener { view ->
+ binding.viewModel?.plantId?.let { plantId ->
+ navigateToPlant(plantId, view)
+ }
+ }
+ }
+
+ private fun navigateToPlant(plantId: String, view: View) {
+ val direction = HomeViewPagerFragmentDirections
+ .actionViewPagerFragmentToPlantDetailFragment(plantId)
+ view.findNavController().navigate(direction)
+ }
+
+ fun bind(plantings: PlantAndGardenPlantings) {
+ with(binding) {
+ viewModel = PlantAndGardenPlantingsViewModel(plantings)
+ executePendingBindings()
+ }
+ }
+ }
+}
+
+private class GardenPlantDiffCallback : DiffUtil.ItemCallback() {
+
+ override fun areItemsTheSame(
+ oldItem: PlantAndGardenPlantings,
+ newItem: PlantAndGardenPlantings
+ ): Boolean {
+ return oldItem.plant.plantId == newItem.plant.plantId
+ }
+
+ override fun areContentsTheSame(
+ oldItem: PlantAndGardenPlantings,
+ newItem: PlantAndGardenPlantings
+ ): Boolean {
+ return oldItem.plant == newItem.plant
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantAdapter.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantAdapter.kt
new file mode 100644
index 000000000..76104880b
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantAdapter.kt
@@ -0,0 +1,91 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.adapters
+
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.navigation.findNavController
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import com.google.samples.apps.sunflower.HomeViewPagerFragmentDirections
+import com.google.samples.apps.sunflower.PlantListFragment
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.databinding.ListItemPlantBinding
+
+/**
+ * Adapter for the [RecyclerView] in [PlantListFragment].
+ */
+class PlantAdapter : ListAdapter(PlantDiffCallback()) {
+
+ override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
+ return PlantViewHolder(
+ ListItemPlantBinding.inflate(
+ LayoutInflater.from(parent.context),
+ parent,
+ false
+ )
+ )
+ }
+
+ override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
+ val plant = getItem(position)
+ (holder as PlantViewHolder).bind(plant)
+ }
+
+ class PlantViewHolder(
+ private val binding: ListItemPlantBinding
+ ) : RecyclerView.ViewHolder(binding.root) {
+ init {
+ binding.setClickListener {
+ binding.plant?.let { plant ->
+ navigateToPlant(plant, it)
+ }
+ }
+ }
+
+ private fun navigateToPlant(
+ plant: Plant,
+ view: View
+ ) {
+ val direction =
+ HomeViewPagerFragmentDirections.actionViewPagerFragmentToPlantDetailFragment(
+ plant.plantId
+ )
+ view.findNavController().navigate(direction)
+ }
+
+ fun bind(item: Plant) {
+ binding.apply {
+ plant = item
+ executePendingBindings()
+ }
+ }
+ }
+}
+
+private class PlantDiffCallback : DiffUtil.ItemCallback() {
+
+ override fun areItemsTheSame(oldItem: Plant, newItem: Plant): Boolean {
+ return oldItem.plantId == newItem.plantId
+ }
+
+ override fun areContentsTheSame(oldItem: Plant, newItem: Plant): Boolean {
+ return oldItem == newItem
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantDetailBindingAdapters.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantDetailBindingAdapters.kt
new file mode 100644
index 000000000..e6b5c542f
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/PlantDetailBindingAdapters.kt
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.adapters
+
+import android.text.method.LinkMovementMethod
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.core.text.HtmlCompat
+import androidx.core.text.HtmlCompat.FROM_HTML_MODE_COMPACT
+import androidx.databinding.BindingAdapter
+import com.bumptech.glide.Glide
+import com.bumptech.glide.load.resource.drawable.DrawableTransitionOptions
+import com.google.android.material.floatingactionbutton.FloatingActionButton
+import com.google.samples.apps.sunflower.R
+
+@BindingAdapter("imageFromUrl")
+fun bindImageFromUrl(view: ImageView, imageUrl: String?) {
+ if (!imageUrl.isNullOrEmpty()) {
+ Glide.with(view.context)
+ .load(imageUrl)
+ .transition(DrawableTransitionOptions.withCrossFade())
+ .into(view)
+ }
+}
+
+@BindingAdapter("isGone")
+fun bindIsGone(view: FloatingActionButton, isGone: Boolean?) {
+ if (isGone == null || isGone) {
+ view.hide()
+ } else {
+ view.show()
+ }
+}
+
+@BindingAdapter("renderHtml")
+fun bindRenderHtml(view: TextView, description: String?) {
+ if (description != null) {
+ view.text = HtmlCompat.fromHtml(description, FROM_HTML_MODE_COMPACT)
+ view.movementMethod = LinkMovementMethod.getInstance()
+ } else {
+ view.text = ""
+ }
+}
+
+@BindingAdapter("wateringText")
+fun bindWateringText(textView: TextView, wateringInterval: Int) {
+ val resources = textView.context.resources
+ val quantityString = resources.getQuantityString(
+ R.plurals.watering_needs_suffix,
+ wateringInterval,
+ wateringInterval
+ )
+
+ textView.text = quantityString
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/SunflowerPagerAdapter.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/SunflowerPagerAdapter.kt
new file mode 100644
index 000000000..ebbea27ce
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/adapters/SunflowerPagerAdapter.kt
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2019 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.adapters
+
+import androidx.fragment.app.Fragment
+import androidx.viewpager2.adapter.FragmentStateAdapter
+import com.google.samples.apps.sunflower.GardenFragment
+import com.google.samples.apps.sunflower.PlantListFragment
+
+const val MY_GARDEN_PAGE_INDEX = 0
+const val PLANT_LIST_PAGE_INDEX = 1
+
+class SunflowerPagerAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {
+
+ /**
+ * Mapping of the ViewPager page indexes to their respective Fragments
+ */
+ private val tabFragmentsCreators: Map Fragment> = mapOf(
+ MY_GARDEN_PAGE_INDEX to { GardenFragment() },
+ PLANT_LIST_PAGE_INDEX to { PlantListFragment() }
+ )
+
+ override fun getItemCount() = tabFragmentsCreators.size
+
+ override fun createFragment(position: Int): Fragment {
+ return tabFragmentsCreators[position]?.invoke() ?: throw IndexOutOfBoundsException()
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/AppDatabase.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/AppDatabase.kt
new file mode 100644
index 000000000..f3a517864
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/AppDatabase.kt
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import android.content.Context
+import androidx.room.Database
+import androidx.room.Room
+import androidx.room.RoomDatabase
+import androidx.room.TypeConverters
+import androidx.sqlite.db.SupportSQLiteDatabase
+import androidx.work.OneTimeWorkRequestBuilder
+import androidx.work.WorkManager
+import com.google.samples.apps.sunflower.utilities.DATABASE_NAME
+import com.google.samples.apps.sunflower.workers.SeedDatabaseWorker
+
+/**
+ * The Room database for this app
+ */
+@Database(entities = [GardenPlanting::class, Plant::class], version = 1, exportSchema = false)
+@TypeConverters(Converters::class)
+abstract class AppDatabase : RoomDatabase() {
+ abstract fun gardenPlantingDao(): GardenPlantingDao
+ abstract fun plantDao(): PlantDao
+
+ companion object {
+
+ // For Singleton instantiation
+ @Volatile private var instance: AppDatabase? = null
+
+ fun getInstance(context: Context): AppDatabase {
+ return instance ?: synchronized(this) {
+ instance ?: buildDatabase(context).also { instance = it }
+ }
+ }
+
+ // Create and pre-populate the database. See this article for more details:
+ // https://medium.com/google-developers/7-pro-tips-for-room-fbadea4bfbd1#4785
+ private fun buildDatabase(context: Context): AppDatabase {
+ return Room.databaseBuilder(context, AppDatabase::class.java, DATABASE_NAME)
+ .addCallback(object : RoomDatabase.Callback() {
+ override fun onCreate(db: SupportSQLiteDatabase) {
+ super.onCreate(db)
+ val request = OneTimeWorkRequestBuilder().build()
+ WorkManager.getInstance(context).enqueue(request)
+ }
+ })
+ .build()
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Converters.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Converters.kt
new file mode 100644
index 000000000..c57d2fe62
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Converters.kt
@@ -0,0 +1,30 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.room.TypeConverter
+import java.util.Calendar
+
+/**
+ * Type converters to allow Room to reference complex data types.
+ */
+class Converters {
+ @TypeConverter fun calendarToDatestamp(calendar: Calendar): Long = calendar.timeInMillis
+
+ @TypeConverter fun datestampToCalendar(value: Long): Calendar =
+ Calendar.getInstance().apply { timeInMillis = value }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlanting.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlanting.kt
new file mode 100644
index 000000000..c133a9fd5
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlanting.kt
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.room.ColumnInfo
+import androidx.room.Entity
+import androidx.room.ForeignKey
+import androidx.room.Index
+import androidx.room.PrimaryKey
+import java.util.Calendar
+
+/**
+ * [GardenPlanting] represents when a user adds a [Plant] to their garden, with useful metadata.
+ * Properties such as [lastWateringDate] are used for notifications (such as when to water the
+ * plant).
+ *
+ * Declaring the column info allows for the renaming of variables without implementing a
+ * database migration, as the column name would not change.
+ */
+@Entity(
+ tableName = "garden_plantings",
+ foreignKeys = [
+ ForeignKey(entity = Plant::class, parentColumns = ["id"], childColumns = ["plant_id"])
+ ],
+ indices = [Index("plant_id")]
+)
+data class GardenPlanting(
+ @ColumnInfo(name = "plant_id") val plantId: String,
+
+ /**
+ * Indicates when the [Plant] was planted. Used for showing notification when it's time
+ * to harvest the plant.
+ */
+ @ColumnInfo(name = "plant_date") val plantDate: Calendar = Calendar.getInstance(),
+
+ /**
+ * Indicates when the [Plant] was last watered. Used for showing notification when it's
+ * time to water the plant.
+ */
+ @ColumnInfo(name = "last_watering_date")
+ val lastWateringDate: Calendar = Calendar.getInstance()
+) {
+ @PrimaryKey(autoGenerate = true)
+ @ColumnInfo(name = "id")
+ var gardenPlantingId: Long = 0
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingDao.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingDao.kt
new file mode 100644
index 000000000..de873f228
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingDao.kt
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.lifecycle.LiveData
+import androidx.room.Dao
+import androidx.room.Delete
+import androidx.room.Insert
+import androidx.room.Query
+import androidx.room.Transaction
+
+/**
+ * The Data Access Object for the [GardenPlanting] class.
+ */
+@Dao
+interface GardenPlantingDao {
+ @Query("SELECT * FROM garden_plantings")
+ fun getGardenPlantings(): LiveData>
+
+ @Query("SELECT EXISTS(SELECT 1 FROM garden_plantings WHERE plant_id = :plantId LIMIT 1)")
+ fun isPlanted(plantId: String): LiveData
+
+ /**
+ * This query will tell Room to query both the [Plant] and [GardenPlanting] tables and handle
+ * the object mapping.
+ */
+ @Transaction
+ @Query("SELECT * FROM plants WHERE id IN (SELECT DISTINCT(plant_id) FROM garden_plantings)")
+ fun getPlantedGardens(): LiveData>
+
+ @Insert
+ fun insertGardenPlanting(gardenPlanting: GardenPlanting): Long
+
+ @Delete
+ fun deleteGardenPlanting(gardenPlanting: GardenPlanting)
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingRepository.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingRepository.kt
new file mode 100644
index 000000000..6e9f1efa5
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/GardenPlantingRepository.kt
@@ -0,0 +1,56 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import kotlinx.coroutines.CoroutineDispatcher
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+class GardenPlantingRepository private constructor(
+ private val gardenPlantingDao: GardenPlantingDao,
+ private val ioDispatcher: CoroutineDispatcher
+) {
+
+ suspend fun createGardenPlanting(plantId: String) {
+ withContext(ioDispatcher) {
+ val gardenPlanting = GardenPlanting(plantId)
+ gardenPlantingDao.insertGardenPlanting(gardenPlanting)
+ }
+ }
+
+ suspend fun removeGardenPlanting(gardenPlanting: GardenPlanting) {
+ gardenPlantingDao.deleteGardenPlanting(gardenPlanting)
+ }
+
+ fun isPlanted(plantId: String) =
+ gardenPlantingDao.isPlanted(plantId)
+
+ fun getPlantedGardens() = gardenPlantingDao.getPlantedGardens()
+
+ companion object {
+
+ // For Singleton instantiation
+ @Volatile private var instance: GardenPlantingRepository? = null
+
+ fun getInstance(gardenPlantingDao: GardenPlantingDao, ioDispatcher: CoroutineDispatcher) =
+ instance ?: synchronized(this) {
+ instance ?: GardenPlantingRepository(gardenPlantingDao, ioDispatcher).also {
+ instance = it
+ }
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Plant.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Plant.kt
new file mode 100644
index 000000000..5dc29c02d
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/Plant.kt
@@ -0,0 +1,44 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.room.ColumnInfo
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+import java.util.Calendar
+import java.util.Calendar.DAY_OF_YEAR
+
+@Entity(tableName = "plants")
+data class Plant(
+ @PrimaryKey @ColumnInfo(name = "id")
+ val plantId: String,
+ val name: String,
+ val description: String,
+ val growZoneNumber: Int,
+ val wateringInterval: Int = 7, // how often the plant should be watered, in days
+ val imageUrl: String = ""
+) {
+
+ /**
+ * Determines if the plant should be watered. Returns true if [since]'s date > date of last
+ * watering + watering Interval; false otherwise.
+ */
+ fun shouldBeWatered(since: Calendar, lastWateringDate: Calendar) =
+ since > lastWateringDate.apply { add(DAY_OF_YEAR, wateringInterval) }
+
+ override fun toString() = name
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantAndGardenPlantings.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantAndGardenPlantings.kt
new file mode 100644
index 000000000..9e7497640
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantAndGardenPlantings.kt
@@ -0,0 +1,32 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.room.Embedded
+import androidx.room.Relation
+
+/**
+ * This class captures the relationship between a [Plant] and a user's [GardenPlanting], which is
+ * used by Room to fetch the related entities.
+ */
+data class PlantAndGardenPlantings(
+ @Embedded
+ val plant: Plant,
+
+ @Relation(parentColumn = "id", entityColumn = "plant_id")
+ val gardenPlantings: List = emptyList()
+)
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantDao.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantDao.kt
new file mode 100644
index 000000000..fba4e5334
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantDao.kt
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import androidx.lifecycle.LiveData
+import androidx.room.Dao
+import androidx.room.Insert
+import androidx.room.OnConflictStrategy
+import androidx.room.Query
+
+/**
+ * The Data Access Object for the Plant class.
+ */
+@Dao
+interface PlantDao {
+ @Query("SELECT * FROM plants ORDER BY name")
+ fun getPlants(): LiveData>
+
+ @Query("SELECT * FROM plants WHERE growZoneNumber = :growZoneNumber ORDER BY name")
+ fun getPlantsWithGrowZoneNumber(growZoneNumber: Int): LiveData>
+
+ @Query("SELECT * FROM plants WHERE id = :plantId")
+ fun getPlant(plantId: String): LiveData
+
+ @Insert(onConflict = OnConflictStrategy.REPLACE)
+ fun insertAll(plants: List)
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantRepository.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantRepository.kt
new file mode 100644
index 000000000..c40f1063f
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/data/PlantRepository.kt
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+/**
+ * Repository module for handling data operations.
+ */
+class PlantRepository private constructor(private val plantDao: PlantDao) {
+
+ fun getPlants() = plantDao.getPlants()
+
+ fun getPlant(plantId: String) = plantDao.getPlant(plantId)
+
+ fun getPlantsWithGrowZoneNumber(growZoneNumber: Int) =
+ plantDao.getPlantsWithGrowZoneNumber(growZoneNumber)
+
+ companion object {
+
+ // For Singleton instantiation
+ @Volatile private var instance: PlantRepository? = null
+
+ fun getInstance(plantDao: PlantDao) =
+ instance ?: synchronized(this) {
+ instance ?: PlantRepository(plantDao).also { instance = it }
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailDescription.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailDescription.kt
new file mode 100644
index 000000000..688af5df2
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailDescription.kt
@@ -0,0 +1,174 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.plantdetail
+
+import android.content.res.Configuration
+import android.text.method.LinkMovementMethod
+import android.widget.TextView
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.wrapContentWidth
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.livedata.observeAsState
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.ExperimentalComposeUiApi
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.dimensionResource
+import androidx.compose.ui.res.pluralStringResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.viewinterop.AndroidView
+import androidx.core.text.HtmlCompat
+import com.google.samples.apps.sunflower.R
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.theme.SunflowerTheme
+import com.google.samples.apps.sunflower.viewmodels.PlantDetailViewModel
+
+@Composable
+fun PlantDetailDescription(plantDetailViewModel: PlantDetailViewModel) {
+ // Observes values coming from the VM's LiveData field as State
+ val plant by plantDetailViewModel.plant.observeAsState()
+
+ // New emissions from plant will make PlantDetailDescription recompose as the state's read here
+ plant?.let {
+ // If plant is not null, display the content
+ PlantDetailContent(it)
+ }
+}
+
+@Composable
+fun PlantDetailContent(plant: Plant) {
+ Surface {
+ Column(Modifier.padding(dimensionResource(R.dimen.margin_normal))) {
+ PlantName(plant.name)
+ PlantWatering(plant.wateringInterval)
+ PlantDescription(plant.description)
+ }
+ }
+}
+
+@Composable
+private fun PlantName(name: String) {
+ Text(
+ text = name,
+ style = MaterialTheme.typography.headlineSmall,
+ modifier = Modifier
+ .fillMaxWidth()
+ .padding(horizontal = dimensionResource(R.dimen.margin_small))
+ .wrapContentWidth(align = Alignment.CenterHorizontally)
+ )
+}
+
+@OptIn(ExperimentalComposeUiApi::class)
+@Composable
+private fun PlantWatering(wateringInterval: Int) {
+ Column(Modifier.fillMaxWidth()) {
+ // Same modifier used by both Texts
+ val centerWithPaddingModifier = Modifier
+ .padding(horizontal = dimensionResource(R.dimen.margin_small))
+ .align(Alignment.CenterHorizontally)
+
+ val normalPadding = dimensionResource(R.dimen.margin_normal)
+
+ Text(
+ text = stringResource(R.string.watering_needs_prefix),
+ color = MaterialTheme.colorScheme.primaryContainer,
+ fontWeight = FontWeight.Bold,
+ modifier = centerWithPaddingModifier.padding(top = normalPadding)
+ )
+
+ val wateringIntervalText = pluralStringResource(
+ R.plurals.watering_needs_suffix,
+ wateringInterval,
+ wateringInterval
+ )
+ Text(
+ text = wateringIntervalText,
+ modifier = centerWithPaddingModifier.padding(bottom = normalPadding)
+ )
+ }
+}
+
+@Composable
+private fun PlantDescription(description: String) {
+ // Remembers the HTML formatted description. Re-executes on a new description
+ val htmlDescription = remember(description) {
+ HtmlCompat.fromHtml(description, HtmlCompat.FROM_HTML_MODE_COMPACT)
+ }
+
+ // Displays the TextView on the screen and updates with the HTML description when inflated
+ // Updates to htmlDescription will make AndroidView recompose and update the text
+ AndroidView(
+ factory = { context ->
+ TextView(context).apply {
+ movementMethod = LinkMovementMethod.getInstance()
+ }
+ },
+ update = {
+ it.text = htmlDescription
+ }
+ )
+}
+
+@Preview
+@Composable
+private fun PlantDetailContentPreview() {
+ val plant = Plant("id", "Apple", "HTML
description", 3, 30, "")
+ SunflowerTheme {
+ PlantDetailContent(plant)
+ }
+}
+
+@Preview(uiMode = Configuration.UI_MODE_NIGHT_YES)
+@Composable
+private fun PlantDetailContentDarkPreview() {
+ val plant = Plant("id", "Apple", "HTML
description", 3, 30, "")
+ SunflowerTheme {
+ PlantDetailContent(plant)
+ }
+}
+
+@Preview
+@Composable
+private fun PlantNamePreview() {
+ SunflowerTheme {
+ PlantName("Apple")
+ }
+}
+
+@Preview
+@Composable
+private fun PlantWateringPreview() {
+ SunflowerTheme {
+ PlantWatering(7)
+ }
+}
+
+@Preview
+@Composable
+private fun PlantDescriptionPreview() {
+ SunflowerTheme {
+ PlantDescription("HTML
description")
+ }
+}
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailFragment.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailFragment.kt
new file mode 100644
index 000000000..526592d59
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/plantdetail/PlantDetailFragment.kt
@@ -0,0 +1,172 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.plantdetail
+
+import android.content.Intent
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.compose.ui.platform.ViewCompositionStrategy
+import androidx.coordinatorlayout.widget.CoordinatorLayout
+import androidx.core.app.ShareCompat
+import androidx.core.widget.NestedScrollView
+import androidx.databinding.DataBindingUtil
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.viewModels
+import androidx.navigation.findNavController
+import androidx.navigation.fragment.navArgs
+import com.google.android.material.floatingactionbutton.FloatingActionButton
+import com.google.android.material.snackbar.Snackbar
+import com.google.samples.apps.sunflower.R
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.databinding.FragmentPlantDetailBinding
+import com.google.samples.apps.sunflower.theme.SunflowerTheme
+import com.google.samples.apps.sunflower.utilities.InjectorUtils
+import com.google.samples.apps.sunflower.viewmodels.PlantDetailViewModel
+
+/**
+ * A fragment representing a single Plant detail screen.
+ */
+class PlantDetailFragment : Fragment() {
+
+ private val args: PlantDetailFragmentArgs by navArgs()
+
+ private val plantDetailViewModel: PlantDetailViewModel by viewModels {
+ InjectorUtils.providePlantDetailViewModelFactory(requireActivity(), args.plantId)
+ }
+
+ override fun onCreateView(
+ inflater: LayoutInflater,
+ container: ViewGroup?,
+ savedInstanceState: Bundle?
+ ): View {
+ val binding = DataBindingUtil.inflate(
+ inflater,
+ R.layout.fragment_plant_detail,
+ container,
+ false
+ ).apply {
+ viewModel = plantDetailViewModel
+ lifecycleOwner = viewLifecycleOwner
+ callback = object : Callback {
+ override fun add(plant: Plant?) {
+ plant?.let {
+ hideAppBarFab(fab)
+ plantDetailViewModel.addPlantToGarden()
+ Snackbar.make(root, R.string.added_plant_to_garden, Snackbar.LENGTH_LONG)
+ .show()
+ }
+ }
+ }
+
+ var isToolbarShown = false
+
+ // scroll change listener begins at Y = 0 when image is fully collapsed
+ plantDetailScrollview.setOnScrollChangeListener(
+ NestedScrollView.OnScrollChangeListener { _, _, scrollY, _, _ ->
+
+ // User scrolled past image to height of toolbar and the title text is
+ // underneath the toolbar, so the toolbar should be shown.
+ val shouldShowToolbar = scrollY > toolbar.height
+
+ // The new state of the toolbar differs from the previous state; update
+ // appbar and toolbar attributes.
+ if (isToolbarShown != shouldShowToolbar) {
+ isToolbarShown = shouldShowToolbar
+
+ // Use shadow animator to add elevation if toolbar is shown
+ appbar.isActivated = shouldShowToolbar
+
+ // Show the plant name if toolbar is shown
+ toolbarLayout.isTitleEnabled = shouldShowToolbar
+ }
+ }
+ )
+
+ toolbar.setNavigationOnClickListener { view ->
+ view.findNavController().navigateUp()
+ }
+
+ toolbar.setOnMenuItemClickListener { item ->
+ when (item.itemId) {
+ R.id.action_share -> {
+ createShareIntent()
+ true
+ }
+ else -> false
+ }
+ }
+
+ composeView.apply {
+ // By default, the Composition is disposed when ComposeView is detached
+ // from the window. This causes problems during transitions as the ComposeView
+ // will still be visible on the screen after it's detached from the window.
+ // Instead, to dispose the Composition when the Fragment view lifecycle is
+ // destroyed, we set the DisposeOnViewTreeLifecycleDestroyed strategy as the
+ // ViewCompositionStrategy for this ComposeView
+ setViewCompositionStrategy(
+ ViewCompositionStrategy.DisposeOnViewTreeLifecycleDestroyed
+ )
+
+ // Add Jetpack Compose content to this View
+ setContent {
+ SunflowerTheme {
+ PlantDetailDescription(plantDetailViewModel)
+ }
+ }
+ }
+ }
+ setHasOptionsMenu(true)
+
+ return binding.root
+ }
+
+ // Helper function for calling a share functionality.
+ // Should be used when user presses a share button/menu item.
+ @Suppress("DEPRECATION")
+ private fun createShareIntent() {
+ val shareText = plantDetailViewModel.plant.value.let { plant ->
+ if (plant == null) {
+ ""
+ } else {
+ getString(R.string.share_text_plant, plant.name)
+ }
+ }
+ val shareIntent = ShareCompat.IntentBuilder.from(requireActivity())
+ .setText(shareText)
+ .setType("text/plain")
+ .createChooserIntent()
+ .addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT or Intent.FLAG_ACTIVITY_MULTIPLE_TASK)
+ startActivity(shareIntent)
+ }
+
+ // FloatingActionButtons anchored to AppBarLayouts have their visibility controlled by the scroll position.
+ // We want to turn this behavior off to hide the FAB when it is clicked.
+ //
+ // This is adapted from Chris Banes' Stack Overflow answer: https://stackoverflow.com/a/41442923
+ private fun hideAppBarFab(fab: FloatingActionButton) {
+ val params = fab.layoutParams as CoordinatorLayout.LayoutParams
+ val behavior = params.behavior as FloatingActionButton.Behavior
+ behavior.isAutoHideEnabled = false
+ fab.hide()
+ }
+
+ interface Callback {
+ fun add(plant: Plant?)
+ }
+}
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/theme/Theme.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/theme/Theme.kt
new file mode 100644
index 000000000..26a43c115
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/theme/Theme.kt
@@ -0,0 +1,57 @@
+/*
+ * Copyright 2023 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.theme
+
+import android.annotation.SuppressLint
+import androidx.compose.foundation.isSystemInDarkTheme
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.darkColorScheme
+import androidx.compose.material3.lightColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.res.colorResource
+import com.google.samples.apps.sunflower.R
+
+@SuppressLint("ConflictingOnColor")
+@Composable
+fun SunflowerTheme(
+ darkTheme: Boolean = isSystemInDarkTheme(),
+ content: @Composable () -> Unit
+) {
+ val lightColors = lightColorScheme(
+ primary = colorResource(id = R.color.sunflower_green_500),
+ primaryContainer = colorResource(id = R.color.sunflower_green_700),
+ secondary = colorResource(id = R.color.sunflower_yellow_500),
+ background = colorResource(id = R.color.sunflower_green_500),
+ onPrimary = colorResource(id = R.color.sunflower_black),
+ onSecondary = colorResource(id = R.color.sunflower_black),
+ )
+ val darkColors = darkColorScheme(
+ primary = colorResource(id = R.color.sunflower_green_100),
+ primaryContainer = colorResource(id = R.color.sunflower_green_200),
+ secondary = colorResource(id = R.color.sunflower_yellow_300),
+ onPrimary = colorResource(id = R.color.sunflower_black),
+ onSecondary = colorResource(id = R.color.sunflower_black),
+ onBackground = colorResource(id = R.color.sunflower_black),
+ surface = colorResource(id = R.color.sunflower_green_100_8pc_over_surface),
+ onSurface = colorResource(id = R.color.sunflower_white),
+ )
+ val colors = if (darkTheme) darkColors else lightColors
+ MaterialTheme(
+ colorScheme = colors,
+ content = content
+ )
+}
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/Constants.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/Constants.kt
new file mode 100644
index 000000000..30eb99477
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/Constants.kt
@@ -0,0 +1,23 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.utilities
+
+/**
+ * Constants used throughout the app.
+ */
+const val DATABASE_NAME = "sunflower-db"
+const val PLANT_DATA_FILENAME = "plants.json"
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/GetZoneForLatitude.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/GetZoneForLatitude.kt
new file mode 100644
index 000000000..d433b8562
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/GetZoneForLatitude.kt
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.utilities
+
+import kotlin.math.abs
+
+/**
+ * A helper function to determine a Plant's growing zone for a given latitude.
+ *
+ * The numbers listed here are roughly based on the United States Department of Agriculture's
+ * Plant Hardiness Zone Map (http://planthardiness.ars.usda.gov/), which helps determine which
+ * plants are most likely to thrive at a location.
+ *
+ * If a given latitude falls on the border between two zone ranges, the larger zone range is chosen
+ * (e.g. latitude 14.0 => zone 12).
+ *
+ * Negative latitude values are converted to positive with [Math.abs].
+ *
+ * For latitude values greater than max (90.0), zone 1 is returned.
+ */
+fun getZoneForLatitude(latitude: Double) = when (abs(latitude)) {
+ in 0.0..7.0 -> 13
+ in 7.0..14.0 -> 12
+ in 14.0..21.0 -> 11
+ in 21.0..28.0 -> 10
+ in 28.0..35.0 -> 9
+ in 35.0..42.0 -> 8
+ in 42.0..49.0 -> 7
+ in 49.0..56.0 -> 6
+ in 56.0..63.0 -> 5
+ in 63.0..70.0 -> 4
+ in 70.0..77.0 -> 3
+ in 77.0..84.0 -> 2
+ else -> 1 // Remaining latitudes are assigned to zone 1.
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/InjectorUtils.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/InjectorUtils.kt
new file mode 100644
index 000000000..460689a78
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/utilities/InjectorUtils.kt
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.utilities
+
+import android.content.Context
+import androidx.fragment.app.Fragment
+import com.google.samples.apps.sunflower.data.AppDatabase
+import com.google.samples.apps.sunflower.data.GardenPlantingRepository
+import com.google.samples.apps.sunflower.data.PlantRepository
+import com.google.samples.apps.sunflower.viewmodels.GardenPlantingListViewModelFactory
+import com.google.samples.apps.sunflower.viewmodels.PlantDetailViewModelFactory
+import com.google.samples.apps.sunflower.viewmodels.PlantListViewModelFactory
+import kotlinx.coroutines.Dispatchers
+
+/**
+ * Static methods used to inject classes needed for various Activities and Fragments.
+ */
+object InjectorUtils {
+
+ private val ioDispatcher = Dispatchers.IO
+
+ private fun getPlantRepository(context: Context): PlantRepository {
+ return PlantRepository.getInstance(
+ AppDatabase.getInstance(context.applicationContext).plantDao()
+ )
+ }
+
+ private fun getGardenPlantingRepository(context: Context): GardenPlantingRepository {
+ return GardenPlantingRepository.getInstance(
+ AppDatabase.getInstance(context.applicationContext).gardenPlantingDao(),
+ ioDispatcher
+ )
+ }
+
+ fun provideGardenPlantingListViewModelFactory(
+ context: Context
+ ): GardenPlantingListViewModelFactory {
+ return GardenPlantingListViewModelFactory(getGardenPlantingRepository(context))
+ }
+
+ fun providePlantListViewModelFactory(fragment: Fragment): PlantListViewModelFactory {
+ return PlantListViewModelFactory(getPlantRepository(fragment.requireContext()), fragment)
+ }
+
+ fun providePlantDetailViewModelFactory(
+ context: Context,
+ plantId: String
+ ): PlantDetailViewModelFactory {
+ return PlantDetailViewModelFactory(
+ getPlantRepository(context),
+ getGardenPlantingRepository(context),
+ plantId
+ )
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModel.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModel.kt
new file mode 100644
index 000000000..d925db4df
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModel.kt
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.ViewModel
+import com.google.samples.apps.sunflower.data.GardenPlantingRepository
+import com.google.samples.apps.sunflower.data.PlantAndGardenPlantings
+
+class GardenPlantingListViewModel internal constructor(
+ gardenPlantingRepository: GardenPlantingRepository
+) : ViewModel() {
+ val plantAndGardenPlantings: LiveData> =
+ gardenPlantingRepository.getPlantedGardens()
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModelFactory.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModelFactory.kt
new file mode 100644
index 000000000..d6d6e173c
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/GardenPlantingListViewModelFactory.kt
@@ -0,0 +1,35 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.ViewModelProvider
+import com.google.samples.apps.sunflower.data.GardenPlantingRepository
+
+/**
+ * Factory for creating a [GardenPlantingListViewModel] with a constructor that takes a
+ * [GardenPlantingRepository].
+ */
+class GardenPlantingListViewModelFactory(
+ private val repository: GardenPlantingRepository
+) : ViewModelProvider.Factory {
+
+ @Suppress("UNCHECKED_CAST")
+ override fun create(modelClass: Class): T {
+ return GardenPlantingListViewModel(repository) as T
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantAndGardenPlantingsViewModel.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantAndGardenPlantingsViewModel.kt
new file mode 100644
index 000000000..50d6bc3b6
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantAndGardenPlantingsViewModel.kt
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import com.google.samples.apps.sunflower.data.PlantAndGardenPlantings
+import java.text.SimpleDateFormat
+import java.util.Locale
+
+class PlantAndGardenPlantingsViewModel(plantings: PlantAndGardenPlantings) {
+ private val plant = checkNotNull(plantings.plant)
+ private val gardenPlanting = plantings.gardenPlantings[0]
+
+ val waterDateString: String = dateFormat.format(gardenPlanting.lastWateringDate.time)
+ val wateringInterval
+ get() = plant.wateringInterval
+ val imageUrl
+ get() = plant.imageUrl
+ val plantName
+ get() = plant.name
+ val plantDateString: String = dateFormat.format(gardenPlanting.plantDate.time)
+ val plantId
+ get() = plant.plantId
+
+ companion object {
+ private val dateFormat = SimpleDateFormat("MMM d, yyyy", Locale.US)
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModel.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModel.kt
new file mode 100644
index 000000000..e22cc0979
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModel.kt
@@ -0,0 +1,43 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import com.google.samples.apps.sunflower.data.GardenPlantingRepository
+import com.google.samples.apps.sunflower.data.PlantRepository
+import com.google.samples.apps.sunflower.plantdetail.PlantDetailFragment
+import kotlinx.coroutines.launch
+
+/**
+ * The ViewModel used in [PlantDetailFragment].
+ */
+class PlantDetailViewModel(
+ plantRepository: PlantRepository,
+ private val gardenPlantingRepository: GardenPlantingRepository,
+ private val plantId: String
+) : ViewModel() {
+
+ val isPlanted = gardenPlantingRepository.isPlanted(plantId)
+ val plant = plantRepository.getPlant(plantId)
+
+ fun addPlantToGarden() {
+ viewModelScope.launch {
+ gardenPlantingRepository.createGardenPlanting(plantId)
+ }
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModelFactory.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModelFactory.kt
new file mode 100644
index 000000000..88670a3d2
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantDetailViewModelFactory.kt
@@ -0,0 +1,39 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.ViewModelProvider
+import com.google.samples.apps.sunflower.data.GardenPlantingRepository
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.data.PlantRepository
+
+/**
+ * Factory for creating a [PlantDetailViewModel] with a constructor that takes a [PlantRepository]
+ * and an ID for the current [Plant].
+ */
+class PlantDetailViewModelFactory(
+ private val plantRepository: PlantRepository,
+ private val gardenPlantingRepository: GardenPlantingRepository,
+ private val plantId: String
+) : ViewModelProvider.Factory {
+
+ @Suppress("UNCHECKED_CAST")
+ override fun create(modelClass: Class): T {
+ return PlantDetailViewModel(plantRepository, gardenPlantingRepository, plantId) as T
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModel.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModel.kt
new file mode 100644
index 000000000..3c8adeeac
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModel.kt
@@ -0,0 +1,62 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.MutableLiveData
+import androidx.lifecycle.SavedStateHandle
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.switchMap
+import com.google.samples.apps.sunflower.PlantListFragment
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.data.PlantRepository
+
+/**
+ * The ViewModel for [PlantListFragment].
+ */
+class PlantListViewModel internal constructor(
+ plantRepository: PlantRepository,
+ private val savedStateHandle: SavedStateHandle
+) : ViewModel() {
+
+ val plants: LiveData> = getSavedGrowZoneNumber().switchMap {
+ if (it == NO_GROW_ZONE) {
+ plantRepository.getPlants()
+ } else {
+ plantRepository.getPlantsWithGrowZoneNumber(it)
+ }
+ }
+
+ fun setGrowZoneNumber(num: Int) {
+ savedStateHandle.set(GROW_ZONE_SAVED_STATE_KEY, num)
+ }
+
+ fun clearGrowZoneNumber() {
+ savedStateHandle.set(GROW_ZONE_SAVED_STATE_KEY, NO_GROW_ZONE)
+ }
+
+ fun isFiltered() = getSavedGrowZoneNumber().value != NO_GROW_ZONE
+
+ private fun getSavedGrowZoneNumber(): MutableLiveData {
+ return savedStateHandle.getLiveData(GROW_ZONE_SAVED_STATE_KEY, NO_GROW_ZONE)
+ }
+
+ companion object {
+ private const val NO_GROW_ZONE = -1
+ private const val GROW_ZONE_SAVED_STATE_KEY = "GROW_ZONE_SAVED_STATE_KEY"
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModelFactory.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModelFactory.kt
new file mode 100644
index 000000000..fca495cfa
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/viewmodels/PlantListViewModelFactory.kt
@@ -0,0 +1,43 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.viewmodels
+
+import android.os.Bundle
+import androidx.lifecycle.AbstractSavedStateViewModelFactory
+import androidx.lifecycle.SavedStateHandle
+import androidx.lifecycle.ViewModel
+import androidx.savedstate.SavedStateRegistryOwner
+import com.google.samples.apps.sunflower.data.PlantRepository
+
+/**
+ * Factory for creating a [PlantListViewModel] with a constructor that takes a [PlantRepository].
+ */
+class PlantListViewModelFactory(
+ private val repository: PlantRepository,
+ owner: SavedStateRegistryOwner,
+ defaultArgs: Bundle? = null
+) : AbstractSavedStateViewModelFactory(owner, defaultArgs) {
+
+ @Suppress("UNCHECKED_CAST")
+ override fun create(
+ key: String,
+ modelClass: Class,
+ handle: SavedStateHandle
+ ): T {
+ return PlantListViewModel(repository, handle) as T
+ }
+}
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/views/MaskedCardView.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/views/MaskedCardView.kt
new file mode 100644
index 000000000..72e73e783
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/views/MaskedCardView.kt
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2019 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.views
+
+import android.annotation.SuppressLint
+import android.content.Context
+import android.graphics.Canvas
+import android.graphics.Path
+import android.graphics.RectF
+import android.util.AttributeSet
+import com.google.android.material.R
+import com.google.android.material.card.MaterialCardView
+import com.google.android.material.shape.ShapeAppearanceModel
+import com.google.android.material.shape.ShapeAppearancePathProvider
+
+/**
+ * A Card view that clips the content of any shape, this should be done upstream in card,
+ * working around it for now.
+ */
+class MaskedCardView @JvmOverloads constructor(
+ context: Context,
+ attrs: AttributeSet? = null,
+ defStyle: Int = R.attr.materialCardViewStyle
+) : MaterialCardView(context, attrs, defStyle) {
+ @SuppressLint("RestrictedApi")
+ private val pathProvider = ShapeAppearancePathProvider()
+ private val path: Path = Path()
+ private val shapeAppearance: ShapeAppearanceModel =
+ ShapeAppearanceModel.builder(
+ context,
+ attrs,
+ defStyle,
+ R.style.Widget_MaterialComponents_CardView
+ ).build()
+
+ private val rectF = RectF(0f, 0f, 0f, 0f)
+
+ override fun onDraw(canvas: Canvas) {
+ canvas.clipPath(path)
+ super.onDraw(canvas)
+ }
+
+ @SuppressLint("RestrictedApi")
+ override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
+ rectF.right = w.toFloat()
+ rectF.bottom = h.toFloat()
+ pathProvider.calculatePath(shapeAppearance, 1f, rectF, path)
+ super.onSizeChanged(w, h, oldw, oldh)
+ }
+}
diff --git a/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/workers/SeedDatabaseWorker.kt b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/workers/SeedDatabaseWorker.kt
new file mode 100644
index 000000000..89063b812
--- /dev/null
+++ b/MigrationCodelab/app/src/main/java/com/google/samples/apps/sunflower/workers/SeedDatabaseWorker.kt
@@ -0,0 +1,57 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.workers
+
+import android.content.Context
+import android.util.Log
+import androidx.work.CoroutineWorker
+import androidx.work.WorkerParameters
+import com.google.gson.Gson
+import com.google.gson.reflect.TypeToken
+import com.google.gson.stream.JsonReader
+import com.google.samples.apps.sunflower.data.AppDatabase
+import com.google.samples.apps.sunflower.data.Plant
+import com.google.samples.apps.sunflower.utilities.PLANT_DATA_FILENAME
+import kotlinx.coroutines.coroutineScope
+
+class SeedDatabaseWorker(
+ context: Context,
+ workerParams: WorkerParameters
+) : CoroutineWorker(context, workerParams) {
+ override suspend fun doWork(): Result = coroutineScope {
+ try {
+ applicationContext.assets.open(PLANT_DATA_FILENAME).use { inputStream ->
+ JsonReader(inputStream.reader()).use { jsonReader ->
+ val plantType = object : TypeToken>() {}.type
+ val plantList: List = Gson().fromJson(jsonReader, plantType)
+
+ val database = AppDatabase.getInstance(applicationContext)
+ database.plantDao().insertAll(plantList)
+
+ Result.success()
+ }
+ }
+ } catch (ex: Exception) {
+ Log.e(TAG, "Error seeding database", ex)
+ Result.failure()
+ }
+ }
+
+ companion object {
+ private const val TAG = "SeedDatabaseWorker"
+ }
+}
diff --git a/MigrationCodelab/app/src/main/res/anim/slide_in_left.xml b/MigrationCodelab/app/src/main/res/anim/slide_in_left.xml
new file mode 100644
index 000000000..2cf890a19
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/anim/slide_in_left.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/anim/slide_in_right.xml b/MigrationCodelab/app/src/main/res/anim/slide_in_right.xml
new file mode 100644
index 000000000..f0d7612f0
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/anim/slide_in_right.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/anim/slide_out_left.xml b/MigrationCodelab/app/src/main/res/anim/slide_out_left.xml
new file mode 100644
index 000000000..fe0cde740
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/anim/slide_out_left.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/anim/slide_out_right.xml b/MigrationCodelab/app/src/main/res/anim/slide_out_right.xml
new file mode 100644
index 000000000..b7ede9b60
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/anim/slide_out_right.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/animator/show_toolbar.xml b/MigrationCodelab/app/src/main/res/animator/show_toolbar.xml
new file mode 100644
index 000000000..7656685b9
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/animator/show_toolbar.xml
@@ -0,0 +1,38 @@
+
+
+
+
+
+ -
+
+
+
+
+
+ -
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/color/color_on_surface_20.xml b/MigrationCodelab/app/src/main/res/color/color_on_surface_20.xml
new file mode 100644
index 000000000..6316b50cb
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/color/color_on_surface_20.xml
@@ -0,0 +1,20 @@
+
+
+
+
+ - diàriament
+ - cada %d dies
+
+
+
+ - cal regar-la demà.
+ - cal regar-la d\'aquí a %d dies.
+
+
+
+ Imatge de la planta
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-de/strings.xml b/MigrationCodelab/app/src/main/res/values-de/strings.xml
new file mode 100644
index 000000000..1abbd0c0c
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-de/strings.xml
@@ -0,0 +1,47 @@
+
+
+
+ Nach Wachstumszone filtern
+ Bild der Pflanze
+ Mein Garten
+ Pflanzenliste
+ Verfügbare Pflanzen
+ Details zur Pflanze
+ Pflanze hinzufügen
+ Pflanze wurde zum Garten hinzugefügt
+ Ihr Garten ist unbepflanzt
+ Gepflanzt
+ Zuletzt gegossen
+ Teilen
+ Schau dir die %s Pflanze in der App "Sunflower" an
+
+
+ Wasserbedarf
+
+ - jeden Tag
+ - alle %d Tage
+
+
+
+ - Morgen gießen
+ - In %d Tagen gießen
+
+
+
+ Bild der Pflanze
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-es/strings.xml b/MigrationCodelab/app/src/main/res/values-es/strings.xml
new file mode 100644
index 000000000..00ca4a5d7
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-es/strings.xml
@@ -0,0 +1,47 @@
+
+
+
+ Filtrar por zona de crecimiento
+ Imagen de la planta
+ Mi jardín
+ Lista de plantas
+ Plantas disponibles
+ Detalles de la planta
+ Añadir planta
+ Planta añadida al jardín
+ Tu jardín esta vacío
+ Plantada
+ Última vez regada
+ Compartir
+ Revisa la planta %s en la aplicación Android Sunflower
+
+
+ Necesita ser regada
+
+ - diariamente.
+ - cada %d días.
+
+
+
+ - regar mañana.
+ - regar en %d días.
+
+
+
+ Imagen de la planta
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-fr/strings.xml b/MigrationCodelab/app/src/main/res/values-fr/strings.xml
new file mode 100644
index 000000000..b5932051c
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-fr/strings.xml
@@ -0,0 +1,49 @@
+
+
+
+ Filtrer par zone de croissance
+ Mon jardin
+ Image de plante
+ Liste des plantes
+ Plantes disponibles
+ Détails sur la plante
+ Ajouter une plante
+ Plante ajoutée à votre jardin
+ Votre jardin est vide
+ Plantée
+ Dernier arrosage
+ Partager
+ Regardez la plante %s sur l\'application Sunflower
+
+
+ Arrosage nécessaire
+
+ - %d fois par jour
+ - Tous les %d jours
+ - Tous les %d jours
+
+
+
+ - à arroser dans %d jour.
+ - à arroser dans %d jours.
+ - à arroser dans %d jours.
+
+
+
+ Image de plante
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-it/strings.xml b/MigrationCodelab/app/src/main/res/values-it/strings.xml
new file mode 100644
index 000000000..80afaa82e
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-it/strings.xml
@@ -0,0 +1,47 @@
+
+
+
+ Filtra per zona di crescita
+ Immagine della pianta
+ Il mio giardino
+ Lista delle piante
+ (translate me) Available Plants
+ Dettagli della pianta
+ Condividi
+ (translate me) Planted
+ (translate me) Last Watered
+ Il tuo giardino è vuoto
+ (translate me) Add plant
+ Pianta aggiunta al giardino
+ Controlla la pianta %s nell\'app Sunflower
+
+
+ Esigenze di irrigazione
+
+ - ogni giorno
+ - ogni %d giorni
+
+
+
+ - annaffia domani.
+ - annaffia tra %d giorni.
+
+
+
+ Immagine della pianta
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values-ja/strings.xml b/MigrationCodelab/app/src/main/res/values-ja/strings.xml
new file mode 100644
index 000000000..1e1887bd1
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-ja/strings.xml
@@ -0,0 +1,46 @@
+
+
+
+ 成長度合いによって分ける
+ 植物のイメージ
+ 私の庭
+ 植物のリスト
+ 選択できる植物
+ 植物の詳細
+ 植物を追加する
+ 植物が庭に追加されました
+ あなたの庭に植物はありません
+ 植えた日
+ 最後に水をあげた日
+ 共有
+ %s という植物を「Sunflower」アプリで見てみてください
+
+
+
+ 水の必要量
+
+ - %d日ごと
+
+
+
+ - %d日後に水をあげてください
+
+
+
+ 植物の写真
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-night-v23/styles.xml b/MigrationCodelab/app/src/main/res/values-night-v23/styles.xml
new file mode 100644
index 000000000..e427d4569
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-night-v23/styles.xml
@@ -0,0 +1,24 @@
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values-night/styles.xml b/MigrationCodelab/app/src/main/res/values-night/styles.xml
new file mode 100644
index 000000000..5b3491144
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-night/styles.xml
@@ -0,0 +1,47 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-ru/strings.xml b/MigrationCodelab/app/src/main/res/values-ru/strings.xml
new file mode 100644
index 000000000..707a69df7
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-ru/strings.xml
@@ -0,0 +1,51 @@
+
+
+
+ Отфильтровать по зоне выращивания
+ Изображение растения
+ Мои сад
+ Растения
+ Доступные растения
+ Добавить растение
+ Ваш сад пуст
+ Поделиться
+ О растении
+ Растение добавлено в ваш сад
+ Посажен
+ Последний полив
+ Попробуйте %s в приложении Android Sunflower
+
+
+ Необходим полив
+
+ - раз в %d день
+ - каждый %d дня
+ - каждые %d дней
+ - каждые %d дней
+
+
+
+ - полить через %d день
+ - полить через %d дня
+ - полить через %d дней
+ - полить через %d дней
+
+
+
+ Изображение растения
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-tr-rTR/strings.xml b/MigrationCodelab/app/src/main/res/values-tr-rTR/strings.xml
new file mode 100644
index 000000000..94e4e38c2
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-tr-rTR/strings.xml
@@ -0,0 +1,47 @@
+
+
+
+ Yetişme bölgesine göre filtrele
+ Bitkinin görüntüsü
+ Bahçem
+ Bitki listesi
+ Mevcut Bitkiler
+ Bitki detayları
+ Bitki Ekle
+ Bitki bahçeye eklendi
+ Bahçen boş
+ Ekiliş Tarihi
+ Son Sulama Tarihi
+ Paylaş
+ %s bitkisini Android Sunflower uygulamasında inceleyin
+
+
+ Sulama gereksinimi:
+
+ - her gün
+ - %d günde bir
+
+
+
+ - yarın sulayın.
+ - %d gün içinde sulayın.
+
+
+
+ Bitkinin görüntüsü
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-v23/styles.xml b/MigrationCodelab/app/src/main/res/values-v23/styles.xml
new file mode 100644
index 000000000..7b6e9173b
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-v23/styles.xml
@@ -0,0 +1,24 @@
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values-v29/shape.xml b/MigrationCodelab/app/src/main/res/values-v29/shape.xml
new file mode 100644
index 000000000..ef6fb49eb
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-v29/shape.xml
@@ -0,0 +1,32 @@
+
+
+
+
+
+
+
+
+ 30dp
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values-zh-rCN/strings.xml b/MigrationCodelab/app/src/main/res/values-zh-rCN/strings.xml
new file mode 100644
index 000000000..0d8a71496
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-zh-rCN/strings.xml
@@ -0,0 +1,46 @@
+
+
+
+ 按生长区筛选
+ 植物图片
+ 我的花园
+ 植物目录
+ 植物品种
+ 植物介绍
+ 添加植物
+ 添加了新植物
+ 花园里还没有植物
+ 种下日期
+ 最后浇水
+ 分享
+ 在安卓 Sunflower APP 上看看这 %s
+
+
+
+ 浇水指南
+
+ - 每隔 %d 天
+
+
+
+ - %d 天后浇水
+
+
+
+ 植物图片
+
+
diff --git a/MigrationCodelab/app/src/main/res/values-zh-rTW/strings.xml b/MigrationCodelab/app/src/main/res/values-zh-rTW/strings.xml
new file mode 100644
index 000000000..2b805ca81
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values-zh-rTW/strings.xml
@@ -0,0 +1,46 @@
+
+
+
+ 按生長區篩選
+ 植物圖片
+ 我的花園
+ 植物目錄
+ 植物品種
+ 植物介紹
+ 添加植物
+ 添加了新植物
+ 花園裡還沒有植物
+ 種下日期
+ 最後澆水
+ 分享
+ 在安卓 Sunflower APP 上看看這 %s
+
+
+
+ 澆水指南
+
+ - 每隔 %d 天
+
+
+
+ - %d 天後澆水
+
+
+
+ 植物圖片
+
+
diff --git a/MigrationCodelab/app/src/main/res/values/anim.xml b/MigrationCodelab/app/src/main/res/values/anim.xml
new file mode 100644
index 000000000..3515c8ba5
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/anim.xml
@@ -0,0 +1,23 @@
+
+
+
+
+
+
+
+ 200
+
diff --git a/MigrationCodelab/app/src/main/res/values/colors.xml b/MigrationCodelab/app/src/main/res/values/colors.xml
new file mode 100644
index 000000000..5c03c17e4
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/colors.xml
@@ -0,0 +1,33 @@
+
+
+
+
+ #de000000
+ #fafafa
+ #99fafafa
+ #eaf6ef
+ #c7e6d3
+ #202221
+ #81ca9d
+ #6dc790
+ #49bb79
+ #005d2b
+ #1a231e
+ #deffffff
+ #f8f99f
+ #ffff63
+
diff --git a/MigrationCodelab/app/src/main/res/values/dimens.xml b/MigrationCodelab/app/src/main/res/values/dimens.xml
new file mode 100644
index 000000000..fd5cfa81f
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/dimens.xml
@@ -0,0 +1,49 @@
+
+
+
+
+
+
+
+ 16dp
+
+
+ 72dp
+
+ 278dp
+
+ 16dp
+ 8dp
+ 4dp
+
+ 95dp
+
+ 12dp
+ 26dp
+ 2dp
+ 12dp
+
+
+ 5dp
+
+
+ 24dp
+
+
+ 555dp
+
+
diff --git a/MigrationCodelab/app/src/main/res/values/integers.xml b/MigrationCodelab/app/src/main/res/values/integers.xml
new file mode 100644
index 000000000..76c669b44
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/integers.xml
@@ -0,0 +1,23 @@
+
+
+
+
+
+
+ 2
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values/shape.xml b/MigrationCodelab/app/src/main/res/values/shape.xml
new file mode 100644
index 000000000..c5ece58c3
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/shape.xml
@@ -0,0 +1,45 @@
+
+
+
+
+
+
+
+
+
+
+
+
+ 12dp
+
+
\ No newline at end of file
diff --git a/MigrationCodelab/app/src/main/res/values/strings.xml b/MigrationCodelab/app/src/main/res/values/strings.xml
new file mode 100644
index 000000000..1cbc497b6
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/strings.xml
@@ -0,0 +1,52 @@
+
+
+
+
+
+ Sunflower
+
+
+ Filter by grow zone
+ Image of plant
+ My garden
+ Plant list
+ Available Plants
+ Plant details
+ Add plant
+ Added plant to garden
+ Your garden is empty
+ Planted
+ Last Watered
+ Share
+ Check out the %s plant in the Android Sunflower app
+
+
+ Watering needs
+
+ - every day
+ - every %d days
+
+
+
+ - water tomorrow.
+ - water in %d days.
+
+
+
+ Picture of plant
+
+
diff --git a/MigrationCodelab/app/src/main/res/values/styles.xml b/MigrationCodelab/app/src/main/res/values/styles.xml
new file mode 100644
index 000000000..e81b8ea64
--- /dev/null
+++ b/MigrationCodelab/app/src/main/res/values/styles.xml
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/ConvertersTest.kt b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/ConvertersTest.kt
new file mode 100644
index 000000000..1eca92cbb
--- /dev/null
+++ b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/ConvertersTest.kt
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import org.junit.Assert.assertEquals
+import org.junit.Test
+import java.util.Calendar
+import java.util.Calendar.DAY_OF_MONTH
+import java.util.Calendar.MONTH
+import java.util.Calendar.SEPTEMBER
+import java.util.Calendar.YEAR
+
+class ConvertersTest {
+
+ private val cal = Calendar.getInstance().apply {
+ set(YEAR, 1998)
+ set(MONTH, SEPTEMBER)
+ set(DAY_OF_MONTH, 4)
+ }
+
+ @Test fun calendarToDatestamp() {
+ assertEquals(cal.timeInMillis, Converters().calendarToDatestamp(cal))
+ }
+
+ @Test fun datestampToCalendar() {
+ assertEquals(Converters().datestampToCalendar(cal.timeInMillis), cal)
+ }
+}
diff --git a/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/GardenPlantingTest.kt b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/GardenPlantingTest.kt
new file mode 100644
index 000000000..5b1836cc1
--- /dev/null
+++ b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/GardenPlantingTest.kt
@@ -0,0 +1,45 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import org.hamcrest.CoreMatchers.equalTo
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertThat
+import org.junit.Test
+import java.util.Calendar
+import java.util.Calendar.DAY_OF_MONTH
+import java.util.Calendar.MONTH
+import java.util.Calendar.YEAR
+
+class GardenPlantingTest {
+
+ @Test
+ fun testDefaultValues() {
+ val gardenPlanting = GardenPlanting("1")
+ val cal = Calendar.getInstance()
+ assertYMD(cal, gardenPlanting.plantDate)
+ assertYMD(cal, gardenPlanting.lastWateringDate)
+ assertEquals(0L, gardenPlanting.gardenPlantingId)
+ }
+
+ // Only Year/Month/Day precision is needed for comparing GardenPlanting Calendar entries
+ private fun assertYMD(expectedCal: Calendar, actualCal: Calendar) {
+ assertThat(actualCal.get(YEAR), equalTo(expectedCal.get(YEAR)))
+ assertThat(actualCal.get(MONTH), equalTo(expectedCal.get(MONTH)))
+ assertThat(actualCal.get(DAY_OF_MONTH), equalTo(expectedCal.get(DAY_OF_MONTH)))
+ }
+}
diff --git a/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/PlantTest.kt b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/PlantTest.kt
new file mode 100644
index 000000000..da847f144
--- /dev/null
+++ b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/data/PlantTest.kt
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.data
+
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+import java.util.Calendar
+import java.util.Calendar.DAY_OF_YEAR
+
+class PlantTest {
+
+ private lateinit var plant: Plant
+
+ @Before fun setUp() {
+ plant = Plant("1", "Tomato", "A red vegetable", 1, 2, "")
+ }
+
+ @Test fun test_default_values() {
+ val defaultPlant = Plant("2", "Apple", "Description", 1)
+ assertEquals(7, defaultPlant.wateringInterval)
+ assertEquals("", defaultPlant.imageUrl)
+ }
+
+ @Test fun test_shouldBeWatered() {
+ Calendar.getInstance().let { now ->
+ // Generate lastWateringDate from being as copy of now.
+ val lastWateringDate = Calendar.getInstance()
+
+ // Test for lastWateringDate is today.
+ lastWateringDate.time = now.time
+ assertFalse(plant.shouldBeWatered(now, lastWateringDate.apply { add(DAY_OF_YEAR, -0) }))
+
+ // Test for lastWateringDate is yesterday.
+ lastWateringDate.time = now.time
+ assertFalse(plant.shouldBeWatered(now, lastWateringDate.apply { add(DAY_OF_YEAR, -1) }))
+
+ // Test for lastWateringDate is the day before yesterday.
+ lastWateringDate.time = now.time
+ assertFalse(plant.shouldBeWatered(now, lastWateringDate.apply { add(DAY_OF_YEAR, -2) }))
+
+ // Test for lastWateringDate is some days ago, three days ago, four days ago etc.
+ lastWateringDate.time = now.time
+ assertTrue(plant.shouldBeWatered(now, lastWateringDate.apply { add(DAY_OF_YEAR, -3) }))
+ }
+ }
+
+ @Test fun test_toString() {
+ assertEquals("Tomato", plant.toString())
+ }
+}
diff --git a/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/utilities/GrowZoneUtilTest.kt b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/utilities/GrowZoneUtilTest.kt
new file mode 100644
index 000000000..7279389be
--- /dev/null
+++ b/MigrationCodelab/app/src/test/java/com/google/samples/apps/sunflower/utilities/GrowZoneUtilTest.kt
@@ -0,0 +1,48 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.google.samples.apps.sunflower.utilities
+
+import org.junit.Assert.assertEquals
+import org.junit.Test
+
+class GrowZoneUtilTest {
+
+ @Test fun getZoneForLatitude() {
+ assertEquals(13, getZoneForLatitude(0.0))
+ assertEquals(13, getZoneForLatitude(7.0))
+ assertEquals(12, getZoneForLatitude(7.1))
+ assertEquals(1, getZoneForLatitude(84.1))
+ assertEquals(1, getZoneForLatitude(90.0))
+ }
+
+ @Test fun getZoneForLatitude_negativeLatitudes() {
+ assertEquals(13, getZoneForLatitude(-7.0))
+ assertEquals(12, getZoneForLatitude(-7.1))
+ assertEquals(1, getZoneForLatitude(-84.1))
+ assertEquals(1, getZoneForLatitude(-90.0))
+ }
+
+ // Bugfix test for https://github.com/android/sunflower/issues/8
+ @Test fun getZoneForLatitude_GitHub_issue8() {
+ assertEquals(9, getZoneForLatitude(35.0))
+ assertEquals(8, getZoneForLatitude(42.0))
+ assertEquals(7, getZoneForLatitude(49.0))
+ assertEquals(6, getZoneForLatitude(56.0))
+ assertEquals(5, getZoneForLatitude(63.0))
+ assertEquals(4, getZoneForLatitude(70.0))
+ }
+}
diff --git a/MigrationCodelab/build.gradle b/MigrationCodelab/build.gradle
new file mode 100644
index 000000000..c0f064965
--- /dev/null
+++ b/MigrationCodelab/build.gradle
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+buildscript {
+ repositories {
+ google()
+ mavenCentral()
+ }
+
+ dependencies {
+ classpath "com.android.tools.build:gradle:9.2.1"
+ classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.3.10"
+ classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.9.8"
+ classpath "org.jetbrains.kotlin:compose-compiler-gradle-plugin:2.3.10"
+ }
+}
+
+plugins {
+ id 'com.diffplug.spotless' version '8.7.0'
+ id 'com.android.legacy-kapt' version '9.2.1' apply false
+}
+
+allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}
+
+spotless {
+ kotlin {
+ target "**/*.kt"
+ targetExclude("$buildDir/**/*.kt")
+ targetExclude('bin/**/*.kt')
+ ktlint("0.46.1")
+ }
+}
diff --git a/MigrationCodelab/gradle.properties b/MigrationCodelab/gradle.properties
new file mode 100644
index 000000000..42979c479
--- /dev/null
+++ b/MigrationCodelab/gradle.properties
@@ -0,0 +1,34 @@
+#
+# Copyright 2018 Google LLC
+#
+# 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
+#
+# https://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.
+#
+
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+android.useAndroidX=true
+org.gradle.jvmargs=-Xmx1536m
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
diff --git a/MigrationCodelab/gradle/wrapper/gradle-wrapper.jar b/MigrationCodelab/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 000000000..b1b8ef56b
Binary files /dev/null and b/MigrationCodelab/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/MigrationCodelab/gradle/wrapper/gradle-wrapper.properties b/MigrationCodelab/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 000000000..eb84db68d
--- /dev/null
+++ b/MigrationCodelab/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,9 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip
+networkTimeout=10000
+retries=0
+retryBackOffMs=500
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/MigrationCodelab/gradlew b/MigrationCodelab/gradlew
new file mode 100755
index 000000000..b9bb139f7
--- /dev/null
+++ b/MigrationCodelab/gradlew
@@ -0,0 +1,248 @@
+#!/bin/sh
+
+#
+# Copyright © 2015 the original authors.
+#
+# 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
+#
+# https://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.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+# Gradle start up script for POSIX generated by Gradle.
+#
+# Important for running:
+#
+# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+# noncompliant, but you have some other compliant shell such as ksh or
+# bash, then to run this script, type that shell name before the whole
+# command line, like:
+#
+# ksh Gradle
+#
+# Busybox and similar reduced shells will NOT work, because this script
+# requires all of these POSIX shell features:
+# * functions;
+# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+# * compound commands having a testable exit status, especially «case»;
+# * various built-in commands including «command», «set», and «ulimit».
+#
+# Important for patching:
+#
+# (2) This script targets any POSIX shell, so it avoids extensions provided
+# by Bash, Ksh, etc; in particular arrays are avoided.
+#
+# The "traditional" practice of packing multiple parameters into a
+# space-separated string is a well documented source of bugs and security
+# problems, so this is (mostly) avoided, by progressively accumulating
+# options in "$@", and eventually passing that to Java.
+#
+# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+# see the in-line comments for details.
+#
+# There are tweaks for specific operating systems such as AIX, CygWin,
+# Darwin, MinGW, and NonStop.
+#
+# (3) This script is generated from the Groovy template
+# https://github.com/gradle/gradle/blob/3d91ce3b8caaf77ad09f381f43615b715b53f72c/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+# within the Gradle project.
+#
+# You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+ APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
+ [ -h "$app_path" ]
+do
+ ls=$( ls -ld "$app_path" )
+ link=${ls#*' -> '}
+ case $link in #(
+ /*) app_path=$link ;; #(
+ *) app_path=$APP_HOME$link ;;
+ esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+ echo "$*"
+} >&2
+
+die () {
+ echo
+ echo "$*"
+ echo
+ exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in #(
+ CYGWIN* ) cygwin=true ;; #(
+ Darwin* ) darwin=true ;; #(
+ MSYS* | MINGW* ) msys=true ;; #(
+ NONSTOP* ) nonstop=true ;;
+esac
+
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD=$JAVA_HOME/jre/sh/java
+ else
+ JAVACMD=$JAVA_HOME/bin/java
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD=java
+ if ! command -v java >/dev/null 2>&1
+ then
+ die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+ case $MAX_FD in #(
+ max*)
+ # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ MAX_FD=$( ulimit -H -n ) ||
+ warn "Could not query maximum file descriptor limit"
+ esac
+ case $MAX_FD in #(
+ '' | soft) :;; #(
+ *)
+ # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ ulimit -n "$MAX_FD" ||
+ warn "Could not set maximum file descriptor limit to $MAX_FD"
+ esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+# * args from the command line
+# * the main class name
+# * -classpath
+# * -D...appname settings
+# * --module-path (only if needed)
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+ APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+
+ JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ for arg do
+ if
+ case $arg in #(
+ -*) false ;; # don't mess with options #(
+ /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
+ [ -e "$t" ] ;; #(
+ *) false ;;
+ esac
+ then
+ arg=$( cygpath --path --ignore --mixed "$arg" )
+ fi
+ # Roll the args list around exactly as many times as the number of
+ # args, so each arg winds up back in the position where it started, but
+ # possibly modified.
+ #
+ # NB: a `for` loop captures its iteration list before it begins, so
+ # changing the positional parameters here affects neither the number of
+ # iterations, nor the values presented in `arg`.
+ shift # remove old arg
+ set -- "$@" "$arg" # push replacement arg
+ done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+# and any embedded shellness will be escaped.
+# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+# treated as '${Hostname}' itself on the command line.
+
+set -- \
+ "-Dorg.gradle.appname=$APP_BASE_NAME" \
+ -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+ "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+ die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+# set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+ printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+ xargs -n1 |
+ sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+ tr '\n' ' '
+ )" '"$@"'
+
+exec "$JAVACMD" "$@"
diff --git a/MigrationCodelab/gradlew.bat b/MigrationCodelab/gradlew.bat
new file mode 100644
index 000000000..aa5f10b06
--- /dev/null
+++ b/MigrationCodelab/gradlew.bat
@@ -0,0 +1,82 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables, and ensure extensions are enabled
+setlocal EnableExtensions
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+"%COMSPEC%" /c exit 1
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+"%COMSPEC%" /c exit 1
+
+:execute
+@rem Setup the command line
+
+
+
+@rem Execute Gradle
+@rem endlocal doesn't take effect until after the line is parsed and variables are expanded
+@rem which allows us to clear the local environment before executing the java command
+endlocal & "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* & call :exitWithErrorLevel
+
+:exitWithErrorLevel
+@rem Use "%COMSPEC%" /c exit to allow operators to work properly in scripts
+"%COMSPEC%" /c exit %ERRORLEVEL%
diff --git a/MigrationCodelab/screenshots/ic_launcher-web.png b/MigrationCodelab/screenshots/ic_launcher-web.png
new file mode 100644
index 000000000..21fe522b1
Binary files /dev/null and b/MigrationCodelab/screenshots/ic_launcher-web.png differ
diff --git a/MigrationCodelab/screenshots/icon_background.png b/MigrationCodelab/screenshots/icon_background.png
new file mode 100644
index 000000000..6f40b4a19
Binary files /dev/null and b/MigrationCodelab/screenshots/icon_background.png differ
diff --git a/MigrationCodelab/screenshots/icon_foreground.png b/MigrationCodelab/screenshots/icon_foreground.png
new file mode 100644
index 000000000..eb3e5a6de
Binary files /dev/null and b/MigrationCodelab/screenshots/icon_foreground.png differ
diff --git a/MigrationCodelab/screenshots/jetpack_donut.png b/MigrationCodelab/screenshots/jetpack_donut.png
new file mode 100644
index 000000000..2259388b9
Binary files /dev/null and b/MigrationCodelab/screenshots/jetpack_donut.png differ
diff --git a/MigrationCodelab/screenshots/phone_my_garden.png b/MigrationCodelab/screenshots/phone_my_garden.png
new file mode 100644
index 000000000..da73fc1e7
Binary files /dev/null and b/MigrationCodelab/screenshots/phone_my_garden.png differ
diff --git a/MigrationCodelab/screenshots/phone_plant_detail.png b/MigrationCodelab/screenshots/phone_plant_detail.png
new file mode 100644
index 000000000..0cd60cedc
Binary files /dev/null and b/MigrationCodelab/screenshots/phone_plant_detail.png differ
diff --git a/MigrationCodelab/screenshots/phone_plant_list.png b/MigrationCodelab/screenshots/phone_plant_list.png
new file mode 100644
index 000000000..a28a65e7d
Binary files /dev/null and b/MigrationCodelab/screenshots/phone_plant_list.png differ
diff --git a/MigrationCodelab/settings.gradle b/MigrationCodelab/settings.gradle
new file mode 100644
index 000000000..fcb112a59
--- /dev/null
+++ b/MigrationCodelab/settings.gradle
@@ -0,0 +1,25 @@
+/*
+ * Copyright 2018 Google LLC
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+pluginManagement {
+ repositories {
+ google()
+ mavenCentral()
+ gradlePluginPortal()
+ }
+}
+
+include ':app'
diff --git a/NavigationCodelab/.gitignore b/NavigationCodelab/.gitignore
new file mode 100644
index 000000000..fee255bb9
--- /dev/null
+++ b/NavigationCodelab/.gitignore
@@ -0,0 +1,17 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.idea/*
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
+.kotlin/
diff --git a/NavigationCodelab/ASSETS_LICENSE b/NavigationCodelab/ASSETS_LICENSE
new file mode 100644
index 000000000..e7fc95866
--- /dev/null
+++ b/NavigationCodelab/ASSETS_LICENSE
@@ -0,0 +1,88 @@
+All font files are licensed under the SIL OPEN FONT LICENSE license. All other files are licensed under the Apache 2 license.
+
+
+SIL OPEN FONT LICENSE
+Version 1.1 - 26 February 2007
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting — in part or in whole — any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
\ No newline at end of file
diff --git a/NavigationCodelab/README.md b/NavigationCodelab/README.md
new file mode 100644
index 000000000..fc80ce26f
--- /dev/null
+++ b/NavigationCodelab/README.md
@@ -0,0 +1,23 @@
+# Navigation in Jetpack Compose Codelab
+
+This folder contains the source code for the
+[Navigation in Jetpack Compose Codelab](https://developer.android.com/codelabs/jetpack-compose-navigation)
+codelab.
+
+## License
+```
+Copyright 2022 The Android Open Source Project
+
+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
+
+ https://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.
+```
+
diff --git a/NavigationCodelab/app/.gitignore b/NavigationCodelab/app/.gitignore
new file mode 100644
index 000000000..42afabfd2
--- /dev/null
+++ b/NavigationCodelab/app/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/NavigationCodelab/app/build.gradle b/NavigationCodelab/app/build.gradle
new file mode 100644
index 000000000..c90bd3abe
--- /dev/null
+++ b/NavigationCodelab/app/build.gradle
@@ -0,0 +1,118 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+plugins {
+ id 'com.android.application'
+ id 'org.jetbrains.kotlin.plugin.compose'
+}
+
+android {
+ compileSdkVersion 37
+ namespace "com.example.compose.rally"
+
+ defaultConfig {
+ applicationId "com.example.compose.rally"
+ minSdkVersion 23
+ targetSdkVersion 33
+ versionCode 1
+ versionName '1.0'
+ testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
+
+ vectorDrawables.useSupportLibrary = true
+ }
+
+ signingConfigs {
+ // We use a bundled debug keystore, to allow debug builds from CI to be upgradable
+ debug {
+ storeFile rootProject.file('debug.keystore')
+ storePassword 'android'
+ keyAlias 'androiddebugkey'
+ keyPassword 'android'
+ }
+ }
+
+ buildTypes {
+ debug {
+ signingConfig signingConfigs.debug
+ }
+
+ release {
+ minifyEnabled true
+ proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+ }
+ }
+
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+
+ buildFeatures {
+ compose true
+ }
+
+ composeOptions {
+ kotlinCompilerExtensionVersion '1.5.15'
+ }
+
+ packagingOptions {
+ exclude "META-INF/licenses/**"
+ exclude "META-INF/AL2.0"
+ exclude "META-INF/LGPL2.1"
+ }
+}
+
+dependencies {
+ def composeBom = platform('androidx.compose:compose-bom:2026.06.00')
+ implementation(composeBom)
+ androidTestImplementation(composeBom)
+
+ implementation "androidx.appcompat:appcompat:1.7.1"
+ implementation "androidx.core:core-ktx:1.19.0"
+ implementation "com.google.android.material:material:1.14.0"
+
+ // Compose
+ implementation "androidx.compose.runtime:runtime"
+ implementation "androidx.compose.ui:ui"
+ implementation "androidx.compose.foundation:foundation"
+ implementation "androidx.compose.material:material"
+ implementation "androidx.compose.material:material-icons-extended"
+ implementation "androidx.activity:activity-compose:1.13.0"
+ implementation "androidx.navigation:navigation-compose:2.9.8"
+ debugImplementation "androidx.compose.ui:ui-tooling"
+
+ // Testing dependencies
+ androidTestImplementation "androidx.arch.core:core-testing:2.2.0"
+ androidTestImplementation "androidx.navigation:navigation-testing:2.9.8"
+ androidTestImplementation "androidx.test.espresso:espresso-contrib:3.7.0"
+ androidTestImplementation "androidx.test.espresso:espresso-core:3.7.0"
+
+ // Compose testing dependencies
+ androidTestImplementation "androidx.compose.ui:ui-test-junit4"
+ debugImplementation "androidx.compose.ui:ui-test-manifest"
+}
+
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+ kotlinOptions {
+ // Treat all Kotlin warnings as errors
+ allWarningsAsErrors = true
+
+ freeCompilerArgs += '-opt-in=kotlin.RequiresOptIn'
+
+ // Set JVM target to 1.8
+ jvmTarget = "1.8"
+ }
+}
diff --git a/NavigationCodelab/app/proguard-rules.pro b/NavigationCodelab/app/proguard-rules.pro
new file mode 100644
index 000000000..4cb94585a
--- /dev/null
+++ b/NavigationCodelab/app/proguard-rules.pro
@@ -0,0 +1,24 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+-renamesourcefileattribute SourceFile
+
+# Repackage classes into the top-level.
+-repackageclasses
diff --git a/NavigationCodelab/app/src/androidTest/java/com/example/compose/rally/NavigationTest.kt b/NavigationCodelab/app/src/androidTest/java/com/example/compose/rally/NavigationTest.kt
new file mode 100644
index 000000000..ea9591f88
--- /dev/null
+++ b/NavigationCodelab/app/src/androidTest/java/com/example/compose/rally/NavigationTest.kt
@@ -0,0 +1,75 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally
+
+import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.test.assertIsDisplayed
+import androidx.compose.ui.test.junit4.createComposeRule
+import androidx.compose.ui.test.onNodeWithContentDescription
+import androidx.compose.ui.test.performClick
+import androidx.compose.ui.test.performScrollTo
+import androidx.navigation.compose.ComposeNavigator
+import androidx.navigation.testing.TestNavHostController
+import org.junit.Assert.assertEquals
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+
+class NavigationTest {
+
+ @get:Rule
+ val composeTestRule = createComposeRule()
+ lateinit var navController: TestNavHostController
+
+ @Before
+ fun setupRallyNavHost() {
+ composeTestRule.setContent {
+ // Creates a TestNavHostController
+ navController = TestNavHostController(LocalContext.current)
+ // Sets a ComposeNavigator to the navController so it can navigate through composables
+ navController.navigatorProvider.addNavigator(ComposeNavigator())
+ RallyNavHost(navController = navController)
+ }
+ }
+
+ @Test
+ fun rallyNavHost_verifyOverviewStartDestination() {
+ composeTestRule
+ .onNodeWithContentDescription("Overview Screen")
+ .assertIsDisplayed()
+ }
+
+ @Test
+ fun rallyNavHost_clickAllAccount_navigatesToAccounts() {
+ composeTestRule
+ .onNodeWithContentDescription("All Accounts")
+ .performClick()
+
+ composeTestRule
+ .onNodeWithContentDescription("Accounts Screen")
+ .assertIsDisplayed()
+ }
+
+ @Test
+ fun rallyNavHost_clickAllBills_navigateToBills() {
+ composeTestRule.onNodeWithContentDescription("All Bills")
+ .performScrollTo()
+ .performClick()
+ val route = navController.currentBackStackEntry?.destination?.route
+ assertEquals(route, "bills")
+ }
+}
diff --git a/NavigationCodelab/app/src/main/AndroidManifest.xml b/NavigationCodelab/app/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..40afec60c
--- /dev/null
+++ b/NavigationCodelab/app/src/main/AndroidManifest.xml
@@ -0,0 +1,43 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyActivity.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyActivity.kt
new file mode 100644
index 000000000..84116f333
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyActivity.kt
@@ -0,0 +1,71 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally
+
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.Scaffold
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.ui.Modifier
+import androidx.navigation.compose.currentBackStackEntryAsState
+import androidx.navigation.compose.rememberNavController
+import com.example.compose.rally.ui.components.RallyTabRow
+import com.example.compose.rally.ui.theme.RallyTheme
+
+/**
+ * This Activity recreates part of the Rally Material Study from
+ * https://material.io/design/material-studies/rally.html
+ */
+class RallyActivity : ComponentActivity() {
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ setContent {
+ RallyApp()
+ }
+ }
+}
+
+@Composable
+fun RallyApp() {
+ RallyTheme {
+ val navController = rememberNavController()
+ val currentBackStack by navController.currentBackStackEntryAsState()
+ val currentDestination = currentBackStack?.destination
+ val currentScreen =
+ rallyTabRowScreens.find { it.route == currentDestination?.route } ?: Accounts
+
+ Scaffold(
+ topBar = {
+ RallyTabRow(
+ allScreens = rallyTabRowScreens,
+ onTabSelected = { newScreen ->
+ navController.navigateSingleTopTo(newScreen.route)
+ },
+ currentScreen = currentScreen
+ )
+ }
+ ) { innerPadding ->
+ RallyNavHost(
+ navController = navController,
+ modifier = Modifier.padding(innerPadding)
+ )
+ }
+ }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyDestinations.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyDestinations.kt
new file mode 100644
index 000000000..1b53193e5
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyDestinations.kt
@@ -0,0 +1,72 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally
+
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.AttachMoney
+import androidx.compose.material.icons.filled.Money
+import androidx.compose.material.icons.filled.MoneyOff
+import androidx.compose.material.icons.filled.PieChart
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.navigation.NavType
+import androidx.navigation.navArgument
+import androidx.navigation.navDeepLink
+
+/**
+ * Contract for information needed on every Rally navigation destination
+ */
+
+sealed interface RallyDestination {
+ val icon: ImageVector
+ val route: String
+}
+
+/**
+ * Rally app navigation destinations
+ */
+data object Overview : RallyDestination {
+ override val icon = Icons.Filled.PieChart
+ override val route = "overview"
+}
+
+data object Accounts : RallyDestination {
+ override val icon = Icons.Filled.AttachMoney
+ override val route = "accounts"
+}
+
+data object Bills : RallyDestination {
+ override val icon = Icons.Filled.MoneyOff
+ override val route = "bills"
+}
+
+data object SingleAccount : RallyDestination {
+ // Added for simplicity, this icon will not in fact be used, as SingleAccount isn't
+ // part of the RallyTabRow selection
+ override val icon = Icons.Filled.Money
+ override val route = "single_account"
+ const val accountTypeArg = "account_type"
+ val routeWithArgs = "$route/{$accountTypeArg}"
+ val arguments = listOf(
+ navArgument(accountTypeArg) { type = NavType.StringType }
+ )
+ val deepLinks = listOf(
+ navDeepLink { uriPattern = "rally://$route/{$accountTypeArg}" }
+ )
+}
+
+// Screens to be displayed in the top RallyTabRow
+val rallyTabRowScreens = listOf(Overview, Accounts, Bills)
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyNavHost.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyNavHost.kt
new file mode 100644
index 000000000..001ad36d1
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/RallyNavHost.kt
@@ -0,0 +1,94 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.navigation.NavGraph.Companion.findStartDestination
+import androidx.navigation.NavHostController
+import androidx.navigation.compose.NavHost
+import androidx.navigation.compose.composable
+import com.example.compose.rally.ui.accounts.AccountsScreen
+import com.example.compose.rally.ui.accounts.SingleAccountScreen
+import com.example.compose.rally.ui.bills.BillsScreen
+import com.example.compose.rally.ui.overview.OverviewScreen
+
+@Composable
+fun RallyNavHost(
+ navController: NavHostController,
+ modifier: Modifier = Modifier
+) {
+ NavHost(
+ navController = navController,
+ startDestination = Overview.route,
+ modifier = modifier
+ ) {
+ composable(route = Overview.route) {
+ OverviewScreen(
+ onClickSeeAllAccounts = {
+ navController.navigateSingleTopTo(Accounts.route)
+ },
+ onClickSeeAllBills = {
+ navController.navigateSingleTopTo(Bills.route)
+ },
+ onAccountClick = { accountType ->
+ navController.navigateToSingleAccount(accountType)
+ }
+ )
+ }
+ composable(route = Accounts.route) {
+ AccountsScreen(
+ onAccountClick = { accountType ->
+ navController.navigateToSingleAccount(accountType)
+ }
+ )
+ }
+ composable(route = Bills.route) {
+ BillsScreen()
+ }
+ composable(
+ route = SingleAccount.routeWithArgs,
+ arguments = SingleAccount.arguments,
+ deepLinks = SingleAccount.deepLinks
+ ) { navBackStackEntry ->
+ val accountType =
+ navBackStackEntry.arguments?.getString(SingleAccount.accountTypeArg)
+ SingleAccountScreen(accountType)
+ }
+ }
+}
+
+fun NavHostController.navigateSingleTopTo(route: String) =
+ this.navigate(route) {
+ // Pop up to the start destination of the graph to
+ // avoid building up a large stack of destinations
+ // on the back stack as users select items
+ popUpTo(
+ this@navigateSingleTopTo.graph.findStartDestination().id
+ ) {
+ saveState = true
+ }
+ // Avoid multiple copies of the same destination when
+ // reselecting the same item
+ launchSingleTop = true
+ // Restore state when reselecting a previously selected item
+ restoreState = true
+ }
+
+private fun NavHostController.navigateToSingleAccount(accountType: String) {
+ this.navigateSingleTopTo("${SingleAccount.route}/$accountType")
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/data/RallyData.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/data/RallyData.kt
new file mode 100644
index 000000000..6434c17d4
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/data/RallyData.kt
@@ -0,0 +1,106 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.data
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.ui.graphics.Color
+
+/* Hard-coded data for the Rally sample. */
+
+@Immutable
+data class Account(
+ val name: String,
+ val number: Int,
+ val balance: Float,
+ val color: Color
+)
+
+@Immutable
+data class Bill(
+ val name: String,
+ val due: String,
+ val amount: Float,
+ val color: Color
+)
+
+/**
+ * Pretend repository for user's data.
+ */
+object UserData {
+ val accounts: List = listOf(
+ Account(
+ "Checking",
+ 1234,
+ 2215.13f,
+ Color(0xFF004940)
+ ),
+ Account(
+ "Home Savings",
+ 5678,
+ 8676.88f,
+ Color(0xFF005D57)
+ ),
+ Account(
+ "Car Savings",
+ 9012,
+ 987.48f,
+ Color(0xFF04B97F)
+ ),
+ Account(
+ "Vacation",
+ 3456,
+ 253f,
+ Color(0xFF37EFBA)
+ )
+ )
+ val bills: List = listOf(
+ Bill(
+ "RedPay Credit",
+ "Jan 29",
+ 45.36f,
+ Color(0xFFFFDC78)
+ ),
+ Bill(
+ "Rent",
+ "Feb 9",
+ 1200f,
+ Color(0xFFFF6951)
+ ),
+ Bill(
+ "TabFine Credit",
+ "Feb 22",
+ 87.33f,
+ Color(0xFFFFD7D0)
+ ),
+ Bill(
+ "ABC Loans",
+ "Feb 29",
+ 400f,
+ Color(0xFFFFAC12)
+ ),
+ Bill(
+ "ABC Loans 2",
+ "Feb 29",
+ 77.4f,
+ Color(0xFFFFAC12)
+ )
+ )
+
+ fun getAccount(accountName: String?): Account {
+ return accounts.first { it.name == accountName }
+ }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/accounts/AccountsScreen.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/accounts/AccountsScreen.kt
new file mode 100644
index 000000000..91da58b21
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/accounts/AccountsScreen.kt
@@ -0,0 +1,82 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.accounts
+
+import androidx.compose.foundation.clickable
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.semantics.semantics
+import com.example.compose.rally.R
+import com.example.compose.rally.data.UserData
+import com.example.compose.rally.ui.components.AccountRow
+import com.example.compose.rally.ui.components.StatementBody
+
+/**
+ * The Accounts screen.
+ */
+@Composable
+fun AccountsScreen(
+ onAccountClick: (String) -> Unit = {},
+) {
+ val amountsTotal = remember { UserData.accounts.map { account -> account.balance }.sum() }
+ StatementBody(
+ modifier = Modifier.semantics { contentDescription = "Accounts Screen" },
+ items = UserData.accounts,
+ amounts = { account -> account.balance },
+ colors = { account -> account.color },
+ amountsTotal = amountsTotal,
+ circleLabel = stringResource(R.string.total),
+ rows = { account ->
+ AccountRow(
+ modifier = Modifier.clickable {
+ onAccountClick(account.name)
+ },
+ name = account.name,
+ number = account.number,
+ amount = account.balance,
+ color = account.color
+ )
+ }
+ )
+}
+
+/**
+ * Detail screen for a single account.
+ */
+@Composable
+fun SingleAccountScreen(
+ accountType: String? = UserData.accounts.first().name
+) {
+ val account = remember(accountType) { UserData.getAccount(accountType) }
+ StatementBody(
+ items = listOf(account),
+ colors = { account.color },
+ amounts = { account.balance },
+ amountsTotal = account.balance,
+ circleLabel = account.name,
+ ) { row ->
+ AccountRow(
+ name = row.name,
+ number = row.number,
+ amount = row.balance,
+ color = row.color
+ )
+ }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/bills/BillsScreen.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/bills/BillsScreen.kt
new file mode 100644
index 000000000..14863b01c
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/bills/BillsScreen.kt
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.bills
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.clearAndSetSemantics
+import androidx.compose.ui.semantics.contentDescription
+import com.example.compose.rally.R
+import com.example.compose.rally.data.Bill
+import com.example.compose.rally.data.UserData
+import com.example.compose.rally.ui.components.BillRow
+import com.example.compose.rally.ui.components.StatementBody
+
+/**
+ * The Bills screen.
+ */
+@Composable
+fun BillsScreen(
+ bills: List = remember { UserData.bills }
+) {
+ StatementBody(
+ modifier = Modifier.clearAndSetSemantics { contentDescription = "Bills" },
+ items = bills,
+ amounts = { bill -> bill.amount },
+ colors = { bill -> bill.color },
+ amountsTotal = bills.map { bill -> bill.amount }.sum(),
+ circleLabel = stringResource(R.string.due),
+ rows = { bill ->
+ BillRow(bill.name, bill.due, bill.amount, bill.color)
+ }
+ )
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/CommonUi.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/CommonUi.kt
new file mode 100644
index 000000000..eed4a3178
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/CommonUi.kt
@@ -0,0 +1,175 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
+import androidx.compose.material.ContentAlpha
+import androidx.compose.material.Divider
+import androidx.compose.material.Icon
+import androidx.compose.material.LocalContentAlpha
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Text
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.ChevronRight
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.clearAndSetSemantics
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.unit.dp
+import com.example.compose.rally.R
+import java.text.DecimalFormat
+
+/**
+ * A row representing the basic information of an Account.
+ */
+@Composable
+fun AccountRow(
+ modifier: Modifier = Modifier,
+ name: String,
+ number: Int,
+ amount: Float,
+ color: Color
+) {
+ BaseRow(
+ modifier = modifier,
+ color = color,
+ title = name,
+ subtitle = stringResource(R.string.account_redacted) + AccountDecimalFormat.format(number),
+ amount = amount,
+ negative = false
+ )
+}
+
+/**
+ * A row representing the basic information of a Bill.
+ */
+@Composable
+fun BillRow(name: String, due: String, amount: Float, color: Color) {
+ BaseRow(
+ color = color,
+ title = name,
+ subtitle = "Due $due",
+ amount = amount,
+ negative = true
+ )
+}
+
+@Composable
+private fun BaseRow(
+ modifier: Modifier = Modifier,
+ color: Color,
+ title: String,
+ subtitle: String,
+ amount: Float,
+ negative: Boolean
+) {
+ val dollarSign = if (negative) "–$ " else "$ "
+ val formattedAmount = formatAmount(amount)
+ Row(
+ modifier = modifier
+ .height(68.dp)
+ .clearAndSetSemantics {
+ contentDescription =
+ "$title account ending in ${subtitle.takeLast(4)}, current balance $dollarSign$formattedAmount"
+ },
+ verticalAlignment = Alignment.CenterVertically
+ ) {
+ val typography = MaterialTheme.typography
+ AccountIndicator(
+ color = color,
+ modifier = Modifier
+ )
+ Spacer(Modifier.width(12.dp))
+ Column(Modifier) {
+ Text(text = title, style = typography.body1)
+ CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.medium) {
+ Text(text = subtitle, style = typography.subtitle1)
+ }
+ }
+ Spacer(Modifier.weight(1f))
+ Row(
+ horizontalArrangement = Arrangement.SpaceBetween
+ ) {
+ Text(
+ text = dollarSign,
+ style = typography.h6,
+ modifier = Modifier.align(Alignment.CenterVertically)
+ )
+ Text(
+ text = formattedAmount,
+ style = typography.h6,
+ modifier = Modifier.align(Alignment.CenterVertically)
+ )
+ }
+ Spacer(Modifier.width(16.dp))
+
+ CompositionLocalProvider(LocalContentAlpha provides ContentAlpha.medium) {
+ Icon(
+ imageVector = Icons.Filled.ChevronRight,
+ contentDescription = null,
+ modifier = Modifier
+ .padding(end = 12.dp)
+ .size(24.dp)
+ )
+ }
+ }
+ RallyDivider()
+}
+
+/**
+ * A vertical colored line that is used in a [BaseRow] to differentiate accounts.
+ */
+@Composable
+private fun AccountIndicator(color: Color, modifier: Modifier = Modifier) {
+ Spacer(
+ modifier
+ .size(4.dp, 36.dp)
+ .background(color = color)
+ )
+}
+
+@Composable
+fun RallyDivider(modifier: Modifier = Modifier) {
+ Divider(color = MaterialTheme.colors.background, thickness = 1.dp, modifier = modifier)
+}
+
+fun formatAmount(amount: Float): String {
+ return AmountDecimalFormat.format(amount)
+}
+
+private val AccountDecimalFormat = DecimalFormat("####")
+private val AmountDecimalFormat = DecimalFormat("#,###.##")
+
+/**
+ * Used with accounts and bills to create the animated circle.
+ */
+fun List.extractProportions(selector: (E) -> Float): List {
+ val total = this.sumOf { selector(it).toDouble() }
+ return this.map { (selector(it) / total).toFloat() }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/DetailsScreen.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/DetailsScreen.kt
new file mode 100644
index 000000000..2445f42bc
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/DetailsScreen.kt
@@ -0,0 +1,83 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.components
+
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material.Card
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.unit.dp
+
+/**
+ * Generic component used by the accounts and bills screens to show a chart and a list of items.
+ */
+@Composable
+fun StatementBody(
+ modifier: Modifier = Modifier,
+ items: List,
+ colors: (T) -> Color,
+ amounts: (T) -> Float,
+ amountsTotal: Float,
+ circleLabel: String,
+ rows: @Composable (T) -> Unit
+) {
+ Column(modifier = modifier.verticalScroll(rememberScrollState())) {
+ Box(Modifier.padding(16.dp)) {
+ val accountsProportion = items.extractProportions { amounts(it) }
+ val circleColors = items.map { colors(it) }
+ AnimatedCircle(
+ accountsProportion,
+ circleColors,
+ Modifier
+ .height(300.dp)
+ .align(Alignment.Center)
+ .fillMaxWidth()
+ )
+ Column(modifier = Modifier.align(Alignment.Center)) {
+ Text(
+ text = circleLabel,
+ style = MaterialTheme.typography.body1,
+ modifier = Modifier.align(Alignment.CenterHorizontally)
+ )
+ Text(
+ text = formatAmount(amountsTotal),
+ style = MaterialTheme.typography.h2,
+ modifier = Modifier.align(Alignment.CenterHorizontally)
+ )
+ }
+ }
+ Spacer(Modifier.height(10.dp))
+ Card {
+ Column(modifier = Modifier.padding(12.dp)) {
+ items.forEach { item ->
+ rows(item)
+ }
+ }
+ }
+ }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAlertDialog.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAlertDialog.kt
new file mode 100644
index 000000000..680ee53cb
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAlertDialog.kt
@@ -0,0 +1,62 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.components
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.PaddingValues
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.AlertDialog
+import androidx.compose.material.Divider
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Text
+import androidx.compose.material.TextButton
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.RectangleShape
+import androidx.compose.ui.unit.dp
+import com.example.compose.rally.ui.theme.RallyDialogThemeOverlay
+
+@Composable
+fun RallyAlertDialog(
+ onDismiss: () -> Unit,
+ bodyText: String,
+ buttonText: String
+) {
+ RallyDialogThemeOverlay {
+ AlertDialog(
+ onDismissRequest = onDismiss,
+ text = { Text(bodyText) },
+ buttons = {
+ Column {
+ Divider(
+ Modifier.padding(horizontal = 12.dp),
+ color = MaterialTheme.colors.onSurface.copy(alpha = 0.2f)
+ )
+ TextButton(
+ onClick = onDismiss,
+ shape = RectangleShape,
+ contentPadding = PaddingValues(16.dp),
+ modifier = Modifier.fillMaxWidth()
+ ) {
+ Text(buttonText)
+ }
+ }
+ }
+ )
+ }
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAnimatedCircle.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAnimatedCircle.kt
new file mode 100644
index 000000000..171e15f80
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyAnimatedCircle.kt
@@ -0,0 +1,109 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.components
+
+import androidx.compose.animation.core.CubicBezierEasing
+import androidx.compose.animation.core.LinearOutSlowInEasing
+import androidx.compose.animation.core.MutableTransitionState
+import androidx.compose.animation.core.animateFloat
+import androidx.compose.animation.core.rememberTransition
+import androidx.compose.animation.core.tween
+import androidx.compose.foundation.Canvas
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.geometry.Offset
+import androidx.compose.ui.geometry.Size
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.drawscope.Stroke
+import androidx.compose.ui.platform.LocalDensity
+import androidx.compose.ui.unit.dp
+
+private const val DividerLengthInDegrees = 1.8f
+
+/**
+ * A donut chart that animates when loaded.
+ */
+@Composable
+fun AnimatedCircle(
+ proportions: List,
+ colors: List,
+ modifier: Modifier = Modifier
+) {
+ val currentState = remember {
+ MutableTransitionState(AnimatedCircleProgress.START)
+ .apply { targetState = AnimatedCircleProgress.END }
+ }
+ val stroke = with(LocalDensity.current) { Stroke(5.dp.toPx()) }
+ val transition = rememberTransition(currentState)
+ val angleOffset by transition.animateFloat(
+ transitionSpec = {
+ tween(
+ delayMillis = 500,
+ durationMillis = 900,
+ easing = LinearOutSlowInEasing
+ )
+ }
+ ) { progress ->
+ if (progress == AnimatedCircleProgress.START) {
+ 0f
+ } else {
+ 360f
+ }
+ }
+ val shift by transition.animateFloat(
+ transitionSpec = {
+ tween(
+ delayMillis = 500,
+ durationMillis = 900,
+ easing = CubicBezierEasing(0f, 0.75f, 0.35f, 0.85f)
+ )
+ }
+ ) { progress ->
+ if (progress == AnimatedCircleProgress.START) {
+ 0f
+ } else {
+ 30f
+ }
+ }
+
+ Canvas(modifier) {
+ val innerRadius = (size.minDimension - stroke.width) / 2
+ val halfSize = size / 2.0f
+ val topLeft = Offset(
+ halfSize.width - innerRadius,
+ halfSize.height - innerRadius
+ )
+ val size = Size(innerRadius * 2, innerRadius * 2)
+ var startAngle = shift - 90f
+ proportions.forEachIndexed { index, proportion ->
+ val sweep = proportion * angleOffset
+ drawArc(
+ color = colors[index],
+ startAngle = startAngle + DividerLengthInDegrees / 2,
+ sweepAngle = sweep - DividerLengthInDegrees,
+ topLeft = topLeft,
+ size = size,
+ useCenter = false,
+ style = stroke
+ )
+ startAngle += sweep
+ }
+ }
+}
+private enum class AnimatedCircleProgress { START, END }
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyTabRow.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyTabRow.kt
new file mode 100644
index 000000000..d9342bf89
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/components/RallyTabRow.kt
@@ -0,0 +1,127 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.components
+
+import androidx.compose.animation.animateColorAsState
+import androidx.compose.animation.animateContentSize
+import androidx.compose.animation.core.LinearEasing
+import androidx.compose.animation.core.tween
+import androidx.compose.foundation.interaction.MutableInteractionSource
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.selection.selectable
+import androidx.compose.foundation.selection.selectableGroup
+import androidx.compose.material.Icon
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Surface
+import androidx.compose.material.Text
+import androidx.compose.material.ripple
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.semantics.Role
+import androidx.compose.ui.semantics.clearAndSetSemantics
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.dp
+import com.example.compose.rally.RallyDestination
+import java.util.Locale
+import androidx.compose.ui.platform.LocalLocale
+
+@Composable
+fun RallyTabRow(
+ allScreens: List,
+ onTabSelected: (RallyDestination) -> Unit,
+ currentScreen: RallyDestination
+) {
+ Surface(
+ Modifier
+ .height(TabHeight)
+ .fillMaxWidth()
+ ) {
+ Row(Modifier.selectableGroup()) {
+ allScreens.forEach { screen ->
+ RallyTab(
+ text = screen.route,
+ icon = screen.icon,
+ onSelected = { onTabSelected(screen) },
+ selected = currentScreen == screen
+ )
+ }
+ }
+ }
+}
+
+@Composable
+private fun RallyTab(
+ text: String,
+ icon: ImageVector,
+ onSelected: () -> Unit,
+ selected: Boolean
+) {
+ val color = MaterialTheme.colors.onSurface
+ val durationMillis = if (selected) TabFadeInAnimationDuration else TabFadeOutAnimationDuration
+ val animSpec = remember {
+ tween(
+ durationMillis = durationMillis,
+ easing = LinearEasing,
+ delayMillis = TabFadeInAnimationDelay
+ )
+ }
+ val tabTintColor by animateColorAsState(
+ targetValue = if (selected) color else color.copy(alpha = InactiveTabOpacity),
+ animationSpec = animSpec
+ )
+ Row(
+ modifier = Modifier
+ .padding(16.dp)
+ .animateContentSize()
+ .height(TabHeight)
+ .selectable(
+ selected = selected,
+ onClick = onSelected,
+ role = Role.Tab,
+ interactionSource = remember { MutableInteractionSource() },
+ indication = ripple(
+ bounded = false,
+ radius = Dp.Unspecified,
+ color = Color.Unspecified
+ )
+ )
+ .clearAndSetSemantics { contentDescription = text }
+ ) {
+ Icon(imageVector = icon, contentDescription = text, tint = tabTintColor)
+ if (selected) {
+ Spacer(Modifier.width(12.dp))
+ Text(text.uppercase(LocalLocale.current.platformLocale), color = tabTintColor)
+ }
+ }
+}
+
+private val TabHeight = 56.dp
+private const val InactiveTabOpacity = 0.60f
+
+private const val TabFadeInAnimationDuration = 150
+private const val TabFadeInAnimationDelay = 100
+private const val TabFadeOutAnimationDuration = 100
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/overview/OverviewScreen.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/overview/OverviewScreen.kt
new file mode 100644
index 000000000..a2a0b7e0a
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/overview/OverviewScreen.kt
@@ -0,0 +1,286 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.overview
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.PaddingValues
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material.Card
+import androidx.compose.material.Icon
+import androidx.compose.material.IconButton
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Text
+import androidx.compose.material.TextButton
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.automirrored.filled.Sort
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.clearAndSetSemantics
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.unit.dp
+import com.example.compose.rally.R
+import com.example.compose.rally.data.UserData
+import com.example.compose.rally.ui.components.AccountRow
+import com.example.compose.rally.ui.components.BillRow
+import com.example.compose.rally.ui.components.RallyAlertDialog
+import com.example.compose.rally.ui.components.RallyDivider
+import com.example.compose.rally.ui.components.formatAmount
+import java.util.Locale
+import androidx.compose.ui.platform.LocalLocale
+
+@Composable
+fun OverviewScreen(
+ onClickSeeAllAccounts: () -> Unit = {},
+ onClickSeeAllBills: () -> Unit = {},
+ onAccountClick: (String) -> Unit = {},
+) {
+ Column(
+ modifier = Modifier
+ .padding(16.dp)
+ .verticalScroll(rememberScrollState())
+ .semantics { contentDescription = "Overview Screen" }
+ ) {
+ AlertCard()
+ Spacer(Modifier.height(RallyDefaultPadding))
+ AccountsCard(
+ onClickSeeAll = onClickSeeAllAccounts,
+ onAccountClick = onAccountClick
+ )
+ Spacer(Modifier.height(RallyDefaultPadding))
+ BillsCard(
+ onClickSeeAll = onClickSeeAllBills
+ )
+ }
+}
+
+/**
+ * The Alerts card within the Rally Overview screen.
+ */
+@Composable
+private fun AlertCard() {
+ var showDialog by remember { mutableStateOf(false) }
+ val alertMessage = "Heads up, you've used up 90% of your Shopping budget for this month."
+
+ if (showDialog) {
+ RallyAlertDialog(
+ onDismiss = {
+ showDialog = false
+ },
+ bodyText = alertMessage,
+ buttonText = "Dismiss".uppercase(LocalLocale.current.platformLocale)
+ )
+ }
+ Card {
+ Column {
+ AlertHeader {
+ showDialog = true
+ }
+ RallyDivider(
+ modifier = Modifier.padding(start = RallyDefaultPadding, end = RallyDefaultPadding)
+ )
+ AlertItem(alertMessage)
+ }
+ }
+}
+
+@Composable
+private fun AlertHeader(onClickSeeAll: () -> Unit) {
+ Row(
+ modifier = Modifier
+ .padding(RallyDefaultPadding)
+ .fillMaxWidth(),
+ horizontalArrangement = Arrangement.SpaceBetween
+ ) {
+ Text(
+ text = "Alerts",
+ style = MaterialTheme.typography.subtitle2,
+ modifier = Modifier.align(Alignment.CenterVertically)
+ )
+ TextButton(
+ onClick = onClickSeeAll,
+ contentPadding = PaddingValues(0.dp),
+ modifier = Modifier.align(Alignment.CenterVertically)
+ ) {
+ Text(
+ text = "SEE ALL",
+ style = MaterialTheme.typography.button,
+ )
+ }
+ }
+}
+
+@Composable
+private fun AlertItem(message: String) {
+ Row(
+ modifier = Modifier
+ .padding(RallyDefaultPadding)
+ // Regard the whole row as one semantics node. This way each row will receive focus as
+ // a whole and the focus bounds will be around the whole row content. The semantics
+ // properties of the descendants will be merged. If we'd use clearAndSetSemantics instead,
+ // we'd have to define the semantics properties explicitly.
+ .semantics(mergeDescendants = true) {},
+ horizontalArrangement = Arrangement.SpaceBetween
+ ) {
+ Text(
+ style = MaterialTheme.typography.body2,
+ modifier = Modifier.weight(1f),
+ text = message
+ )
+ IconButton(
+ onClick = {},
+ modifier = Modifier
+ .align(Alignment.Top)
+ .clearAndSetSemantics {}
+ ) {
+ Icon(Icons.AutoMirrored.Filled.Sort, contentDescription = null)
+ }
+ }
+}
+
+/**
+ * Base structure for cards in the Overview screen.
+ */
+@Composable
+private fun OverviewScreenCard(
+ title: String,
+ amount: Float,
+ onClickSeeAll: () -> Unit,
+ values: (T) -> Float,
+ colors: (T) -> Color,
+ data: List,
+ row: @Composable (T) -> Unit
+) {
+ Card {
+ Column {
+ Column(Modifier.padding(RallyDefaultPadding)) {
+ Text(text = title, style = MaterialTheme.typography.subtitle2)
+ val amountText = "$" + formatAmount(
+ amount
+ )
+ Text(text = amountText, style = MaterialTheme.typography.h2)
+ }
+ OverViewDivider(data, values, colors)
+ Column(Modifier.padding(start = 16.dp, top = 4.dp, end = 8.dp)) {
+ data.take(SHOWN_ITEMS).forEach { row(it) }
+ SeeAllButton(
+ modifier = Modifier.clearAndSetSemantics {
+ contentDescription = "All $title"
+ },
+ onClick = onClickSeeAll,
+ )
+ }
+ }
+ }
+}
+
+@Composable
+private fun OverViewDivider(
+ data: List,
+ values: (T) -> Float,
+ colors: (T) -> Color
+) {
+ Row(Modifier.fillMaxWidth()) {
+ data.forEach { item: T ->
+ Spacer(
+ modifier = Modifier
+ .weight(values(item))
+ .height(1.dp)
+ .background(colors(item))
+ )
+ }
+ }
+}
+
+/**
+ * The Accounts card within the Rally Overview screen.
+ */
+@Composable
+private fun AccountsCard(onClickSeeAll: () -> Unit, onAccountClick: (String) -> Unit) {
+ val amount = UserData.accounts.map { account -> account.balance }.sum()
+ OverviewScreenCard(
+ title = stringResource(R.string.accounts),
+ amount = amount,
+ onClickSeeAll = onClickSeeAll,
+ data = UserData.accounts,
+ colors = { it.color },
+ values = { it.balance }
+ ) { account ->
+ AccountRow(
+ modifier = Modifier.clickable { onAccountClick(account.name) },
+ name = account.name,
+ number = account.number,
+ amount = account.balance,
+ color = account.color
+ )
+ }
+}
+
+/**
+ * The Bills card within the Rally Overview screen.
+ */
+@Composable
+private fun BillsCard(onClickSeeAll: () -> Unit) {
+ val amount = UserData.bills.map { bill -> bill.amount }.sum()
+ OverviewScreenCard(
+ title = stringResource(R.string.bills),
+ amount = amount,
+ onClickSeeAll = onClickSeeAll,
+ data = UserData.bills,
+ colors = { it.color },
+ values = { it.amount }
+ ) { bill ->
+ BillRow(
+ name = bill.name,
+ due = bill.due,
+ amount = bill.amount,
+ color = bill.color
+ )
+ }
+}
+
+@Composable
+private fun SeeAllButton(modifier: Modifier = Modifier, onClick: () -> Unit) {
+ TextButton(
+ onClick = onClick,
+ modifier = modifier
+ .height(44.dp)
+ .fillMaxWidth()
+ ) {
+ Text(stringResource(R.string.see_all))
+ }
+}
+
+private val RallyDefaultPadding = 12.dp
+
+private const val SHOWN_ITEMS = 3
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Color.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Color.kt
new file mode 100644
index 000000000..bfa24979a
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Color.kt
@@ -0,0 +1,32 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.theme
+
+import androidx.compose.material.darkColors
+import androidx.compose.ui.graphics.Color
+
+val Green500 = Color(0xFF1EB980)
+val DarkBlue900 = Color(0xFF26282F)
+
+// Rally is always dark themed.
+val ColorPalette = darkColors(
+ primary = Green500,
+ surface = DarkBlue900,
+ onSurface = Color.White,
+ background = DarkBlue900,
+ onBackground = Color.White
+)
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/RallyTheme.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/RallyTheme.kt
new file mode 100644
index 000000000..4b690b7ef
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/RallyTheme.kt
@@ -0,0 +1,65 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.theme
+
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Typography
+import androidx.compose.material.darkColors
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.compositeOver
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.em
+import androidx.compose.ui.unit.sp
+
+/**
+ * A [MaterialTheme] for Rally.
+ */
+@Composable
+fun RallyTheme(content: @Composable () -> Unit) {
+
+ MaterialTheme(colors = ColorPalette, typography = Typography, content = content)
+}
+
+/**
+ * A theme overlay used for dialogs.
+ */
+@Composable
+fun RallyDialogThemeOverlay(content: @Composable () -> Unit) {
+ // Rally is always dark themed.
+ val dialogColors = darkColors(
+ primary = Color.White,
+ surface = Color.White.copy(alpha = 0.12f).compositeOver(Color.Black),
+ onSurface = Color.White
+ )
+
+ // Copy the current [Typography] and replace some text styles for this theme.
+ val currentTypography = MaterialTheme.typography
+ val dialogTypography = currentTypography.copy(
+ body2 = currentTypography.body1.copy(
+ fontWeight = FontWeight.Normal,
+ fontSize = 20.sp,
+ lineHeight = 28.sp,
+ letterSpacing = 1.sp
+ ),
+ button = currentTypography.button.copy(
+ fontWeight = FontWeight.Bold,
+ letterSpacing = 0.2.em
+ )
+ )
+ MaterialTheme(colors = dialogColors, typography = dialogTypography, content = content)
+}
diff --git a/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Type.kt b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Type.kt
new file mode 100644
index 000000000..45e4f79b1
--- /dev/null
+++ b/NavigationCodelab/app/src/main/java/com/example/compose/rally/ui/theme/Type.kt
@@ -0,0 +1,105 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * 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
+ *
+ * https://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.
+ */
+
+package com.example.compose.rally.ui.theme
+
+import androidx.compose.material.Typography
+import androidx.compose.ui.text.TextStyle
+import androidx.compose.ui.text.font.Font
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.em
+import androidx.compose.ui.unit.sp
+import com.example.compose.rally.R
+
+private val EczarFontFamily = FontFamily(
+ Font(R.font.eczar_regular),
+ Font(R.font.eczar_semibold, FontWeight.SemiBold)
+)
+private val RobotoCondensed = FontFamily(
+ Font(R.font.robotocondensed_regular),
+ Font(R.font.robotocondensed_light, FontWeight.Light),
+ Font(R.font.robotocondensed_bold, FontWeight.Bold)
+)
+
+val Typography = Typography(
+ defaultFontFamily = RobotoCondensed,
+ h1 = TextStyle(
+ fontWeight = FontWeight.W100,
+ fontSize = 96.sp,
+ ),
+ h2 = TextStyle(
+ fontWeight = FontWeight.SemiBold,
+ fontSize = 44.sp,
+ fontFamily = EczarFontFamily,
+ letterSpacing = 1.5.sp
+ ),
+ h3 = TextStyle(
+ fontWeight = FontWeight.W400,
+ fontSize = 14.sp
+ ),
+ h4 = TextStyle(
+ fontWeight = FontWeight.W700,
+ fontSize = 34.sp
+ ),
+ h5 = TextStyle(
+ fontWeight = FontWeight.W700,
+ fontSize = 24.sp
+ ),
+ h6 = TextStyle(
+ fontWeight = FontWeight.Normal,
+ fontSize = 18.sp,
+ lineHeight = 20.sp,
+ fontFamily = EczarFontFamily,
+ letterSpacing = 3.sp
+ ),
+ subtitle1 = TextStyle(
+ fontWeight = FontWeight.Light,
+ fontSize = 14.sp,
+ lineHeight = 20.sp,
+ letterSpacing = 3.sp
+ ),
+ subtitle2 = TextStyle(
+ fontWeight = FontWeight.Normal,
+ fontSize = 14.sp,
+ letterSpacing = 0.1.em
+ ),
+ body1 = TextStyle(
+ fontWeight = FontWeight.Normal,
+ fontSize = 16.sp,
+ letterSpacing = 0.1.em
+ ),
+ body2 = TextStyle(
+ fontWeight = FontWeight.Normal,
+ fontSize = 14.sp,
+ lineHeight = 20.sp,
+ letterSpacing = 0.1.em
+ ),
+ button = TextStyle(
+ fontWeight = FontWeight.Bold,
+ fontSize = 14.sp,
+ lineHeight = 16.sp,
+ letterSpacing = 0.2.em
+ ),
+ caption = TextStyle(
+ fontWeight = FontWeight.W500,
+ fontSize = 12.sp
+ ),
+ overline = TextStyle(
+ fontWeight = FontWeight.W500,
+ fontSize = 10.sp
+ )
+)
diff --git a/NavigationCodelab/app/src/main/res/drawable-v26/ic_launcher_foreground.xml b/NavigationCodelab/app/src/main/res/drawable-v26/ic_launcher_foreground.xml
new file mode 100644
index 000000000..f266f0cfe
--- /dev/null
+++ b/NavigationCodelab/app/src/main/res/drawable-v26/ic_launcher_foreground.xml
@@ -0,0 +1,72 @@
+
+
+
+
+
+
+
+
+
+
+
+
+