From cc1cb95dfd4ad5406964d64a5d88770de796f2af Mon Sep 17 00:00:00 2001 From: Pun Butrach Date: Fri, 10 Oct 2025 05:15:00 +0700 Subject: [PATCH] docs: prebuilts info, pflsui, VERIFICATION.md Signed-off-by: Pun Butrach --- CONTRIBUTING.md | 5 +++-- VERIFICATION.md | 14 +++++++------- docs/assets/README.md | 22 ++++++++++------------ prebuilts/libs/README.md | 26 +++++++++++++------------- 4 files changed, 33 insertions(+), 34 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 49466708e8..cd658c334d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -61,10 +61,12 @@ Here are some contribution tips to help you get started: ### Additional documentation - [Lawnchair roadmap](ROADMAP.md) +- [Lawnchair verification](VERIFICATION.md) - [The Lawnchair Wiki](https://github.com/LawnchairLauncher/lawnchair/wiki) - [Lawnchair Visual Guidelines](/docs/assets/README.md) - [Lawnchair Quickstep Compat Library](compatLib/README.md) - [Lawnchair Preferences Components](lawnchair/src/app/lawnchair/ui/preferences/components/README.md) +- [Lawnchair Platform Frameworks Library SystemUI](platform_frameworks_libs_systemui/README.md) - [SystemUI Module](systemUI/README.md) - [ViewCapture](systemUI/viewcapture/README.md) - [Common](systemUI/common/README.md) @@ -92,8 +94,7 @@ We follow the **[Conventional Commits specification][conventional-commits]**. ### Versioning scheme -As of Lawnchair 15 Beta 1, Lawnchair’s version code is composed of five parts, separated by -underscores: +Lawnchair’s version code is composed of five parts, separated by underscores:

diff --git a/VERIFICATION.md b/VERIFICATION.md index 90f65d56f8..2e78cb8dcc 100644 --- a/VERIFICATION.md +++ b/VERIFICATION.md @@ -1,32 +1,32 @@ # Lawnchair verification -Lawnchair apk are cryptographically signed and can be verified using two verifications system. +Lawnchair apk are cryptographically signed and can be verified using two verification systems 1. GitHub or SLSA attestations 2. SHA256 of android app certificate ## SLSA Attestation -Lawnchair repository is SLSA-Level 2 compliance and can be verified using a provenance. - > [!NOTE] -> It is possible to verify without GitHub CLI by cross-referencing check from +> It is possible to verify without GitHub CLI by cross-referencing check > [GitHub Attestation][github-attestation] with [Sigstore Rekor][sigstore-rekor] +Lawnchair repository is SLSA-Level 2 compliance + 1. Install GitHub CLI 2. Download the APK and attestation from [GitHub Attestation][github-attestation] -3. Run `gh attestation verify APK -R LawnchairLauncher/lawnchair`, replace {APK} with the +3. Run `gh attestation verify {APK} -R LawnchairLauncher/lawnchair`, replace {APK} with the actual APK file 4. Done ## Android App Certificate -Lawnchair have two app certificates: +Lawnchair have two app certificates, usually: * Google Play: `47:AC:92:63:1C:60:35:13:CC:8D:26:DD:9C:FF:E0:71:9A:8B:36:55:44:DC:CE:C2:09:58:24:EC:25:61:20:A7` * Elsewhere: `74:7C:36:45:B3:57:25:8B:2E:23:E8:51:E5:3C:96:74:7F:E0:AD:D0:07:E5:BA:2C:D9:7E:8C:85:57:2E:4D:C5` -On Android, using a verification app like [AppVerifier][3p-appverifier] can ease up the verifying process. +Using a verification app like [AppVerifier][3p-appverifier] can ease up the verifying process. [github-attestation]: https://github.com/LawnchairLauncher/lawnchair/attestations [sigstore-rekor]: https://search.sigstore.dev/ diff --git a/docs/assets/README.md b/docs/assets/README.md index 51ef527d05..30e6cb7568 100644 --- a/docs/assets/README.md +++ b/docs/assets/README.md @@ -1,21 +1,19 @@ -# Lawnchair Visual Guidelines +# Lawnchair Assets Guidelines This directory lists all the decoration & visual explainers used in the Lawnchair Documentation. -All assets created should use Material 3 design with `#47B84F` as source color and +All assets created should use Material 3 design with `#47B84F` as source color, and the [Inter](https://fonts.google.com/specimen/Inter) ([OFL v1.1](https://github.com/rsms/inter/?tab=OFL-1.1-1-ov-file#readme)) -typography. Visit the [Material 3 theme builder][material-theme-builder] for more information. +typography. -When creating device mockups for Lawnchair, make sure that you're using the latest commits of -Lawnchair or use Lawnchair Nightly as base. +Visit the [Material 3 theme builder][material-theme-builder] for more information on color. -## Device Mockup +## Device mockup -Use in: [README](/README.md) - -* Icon pack: [Lawnicons](https://github.com/LawnchairLauncher/lawnicons) -* Wallpaper: https://unsplash.com/photos/photography-of-green-leaves-ZVKr8wADhpc -* Color Extraction Technique: Tonal Spot from Lawnchair -* License: https://unsplash.com/license +When creating device mockups for Lawnchair, make sure the latest stable commits of Lawnchair is use +as base. All wallpapers, fonts and icon packs are allowed as long as they're free-to-use +under a permissive license like the licenses from Creative-Common. Using vanilla out-of-the-box +experience is recommended because they show the user what to expect from Lawnchair Launcher when +they first use it. [material-theme-builder]: https://material-foundation.github.io/material-theme-builder/?primary=%2347B84F&bodyFont=Inter&displayFont=Inter&colorMatch=false diff --git a/prebuilts/libs/README.md b/prebuilts/libs/README.md index 584a1b9103..57d658299a 100644 --- a/prebuilts/libs/README.md +++ b/prebuilts/libs/README.md @@ -7,19 +7,19 @@ To build Lawnchair, you have to build AOSP and obtain these JARs. Lawnchair rely on these JAR: -| File | Command | Android Tag | Target Configuration | -|----------------------------|-------------------------|-------------------|-----------------------------------------------------| -| framework-16.jar | `m framework` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | -| SystemUI-statsd-16.jar | `m SystemUI-statsd` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | -| WindowManager-Shell-16.jar | `m WindowManager-Shell` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | -| SystemUI-core-16.jar | `m SystemUI-core` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | -| framework-15.jar | `m framework` | | | -| framework-14.jar | `m framework` | | | -| framework-13.jar | `m framework` | | | -| framework-12l.jar | `m framework` | | | -| framework-12.jar | `m framework` | | | -| framework-11.jar | `m framework` | | | -| framework-10.jar | `m framework` | | | +| File | Command | Android Tag | Target Configuration | +|----------------------------|-------------------------|-----------------------------|----------------------------------------------------| +| framework-16.jar | `m framework` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | +| SystemUI-statsd-16.jar | `m SystemUI-statsd` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | +| WindowManager-Shell-16.jar | `m WindowManager-Shell` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | +| SystemUI-core-16.jar | `m SystemUI-core` | android-16.0.0_r2 | `aosp_cf_x86_64_only_phone-aosp_current-userdebug` | +| framework-15.jar | `m framework` | android-15.0.0_r3 | | +| framework-14.jar | `m framework` | android14-release | | +| framework-13.jar | `m framework` | | | +| framework-12l.jar | `m framework` | android12L-platform-release | | +| framework-12.jar | `m framework` | android12-platform-release | | +| framework-11.jar | `m framework` | android-11.0.0_r18 | | +| framework-10.jar | `m framework` | | | Location of the generated JARs: