[external/jetpack-camera-app] Upstream merge am: 4919941812 am: 310a14dd9e

Original change: https://android-review.googlesource.com/c/platform/external/jetpack-camera-app/+/3263806

Change-Id: I5a11c0c61dc54c3d7c026892d6fb144e1a8602e2
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: cedf9c28de946402d388c8abf865bb51dec428a3
  1. .github/
  2. .idea/
  3. app/
  4. benchmark/
  5. core/
  6. data/
  7. docs/
  8. feature/
  9. gradle/
  10. hooks/
  11. spotless/
  12. .editorconfig
  13. .gitignore
  14. Android.bp
  15. build.gradle.kts
  16. gradle.properties
  17. gradlew
  18. gradlew.bat
  19. LICENSE
  20. METADATA
  21. MODULE_LICENSE_APACHE2
  22. OWNERS
  23. README.md
  24. settings.gradle.kts
  25. TEST_MAPPING
README.md

Video Capture with Jetpack Camera App

Jetpack Camera App ๐Ÿ“ธ

Jetpack Camera App (JCA) is a camera app, focused on features used by app developers, and built entirely with CameraX, Kotlin and Jetpack Compose. It follows Android design and development best practices and it's intended to be a useful reference for developers and OEMs looking to validate their camera feature implementations.

Development Environment โš’๏ธ

This project uses the gradle build system, and can be imported directly into Android Studio.

Currently, Jetpack Camera App is built using the Android Gradle Plugin 8.4, which is only compatible with Android Studio Jellyfish or newer.

Architecture ๐Ÿ“

JCA is built with modern android development (MAD) principles in mind, including architecture and testing best practices.

The app is split into multiple modules, with a clear separation between the UI and data layers.

Testing ๐Ÿงช

Thorough testing is a key directive of JCA. We use Compose Test and UI Automator to write instrumentation tests that run on-device.

These tests can be run on a connected device via Android Studio, or can be tested on an Android Emulator using built-in Gradle Managed Device tasks. Currently, we include Pixel 2 (API 28) and Pixel 8 (API 34) emulators which can be used to run instrumentation tests with:

$ ./gradlew pixel2Api28DebugAndroidTest and $ ./gradlew pixel8Api34DebugAndroidTest

Source Code Headers

Every file containing source code must include copyright and license information. This includes any JS/CSS files that you might be serving out to browsers. (This is to help well-intentioned people avoid accidental copying that doesn't comply with the license.)

Apache header:

Copyright (C) 2024 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.