Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

android-expert

/android-expert

Obsługuje warstwę Androida w katalogu amethyst/: MainActivity, AndroidManifest, filtry intencji, proces :napplet, warianty play i fdroid, R8, uprawnienia oraz porty Intent i Context.

Repozytorium
amethyst ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Obsługuje warstwę Androida w katalogu amethyst/: MainActivity, AndroidManifest, filtry intencji, proces :napplet, warianty play i fdroid, R8, uprawnienia oraz porty Intent i Context.

Oryginalny opis (EN)

Android shim in `amethyst/`: MainActivity, AndroidManifest/intent filters, :napplet process, play/fdroid flavors, R8 + tools/r8-verify, permissions, Intent/Context ports. Use when editing amethyst/. NOT for screens/navigation (compose-expert).

Jak działa

  1. Entry points
  2. Two processes
  3. Manifest and intents
  4. Intent / Context access from shared UI
  5. Flavors: play vs fdroid
  6. Images (Coil)
  7. R8 and release checks
  8. Testing
Sekcje z nagłówków SKILL.md, w oryginale · 126 linii, 786 słów
Podgląd SKILL.md
---
name: android-expert
description: Android shim in `amethyst/`: MainActivity, AndroidManifest/intent filters, :napplet process, play/fdroid flavors, R8 + tools/r8-verify, permissions, Intent/Context ports. Use when editing amethyst/. NOT for screens/navigation (compose-expert).
---

# android-expert

`amethyst/` is shrinking to an Android shim: entry points, services, system integrations and
the actuals of shared ports. Screens, the nav host and the bar / rail / drawer are shared UI in
`commonsUI` (see `compose-expert`). A new screen goes there even when only Android shows it.

Source root: `amethyst/src/main/java/com/vitorpamplona/amethyst/` (an Android app module, not
KMP: there is no `androidMain` here). Flavor code is in `amethyst/src/play/` and
`amethyst/src/fdroid/`.

## Entry points

- `Amethyst.kt`: the `Application`. Builds `AppModules` (`Amethyst.instance`) in the main
  process only.
- `ui/MainActivity.kt`: the single main Activity (`launchMode="singleInstance"`).
  `onCreate` calls `enableEdgeToEdge()` and sets
  `AmethystTheme { ... AmethystApp(Amethyst.instance.sessionManager, AndroidAppRoot) }`.
  Everything from there down is shared UI.
- `ui/AndroidAppRoot.kt`: `object AndroidAppRoot : AppRoot`, Android's implementation of the
  shared shell port (`commonsUI/.../commons/ui/app/AppRoot.kt`). It registers the Android-only
  destinations (`androidDestinations` in `ui/navigation/AppNavigation.kt`) and runs
  `NavigateIfIntentRequested`.
- `ui/platform/AndroidAppPlatform.kt` (`AppPlatform`) and `ui/platform/AndroidAppServices.kt`
  (`AppServices`, the interface is in `commons/.../commons/service/AppServices.kt`): the other two
  ports the shared UI calls.
- Other activities have their own windows: `ui/call/CallActivity`,
  `ui/screen/loggedIn/nests/room/activity/NestActivity`, `service/playback/pip/PipVideoActivity`,
  the signer / napplet consent activities, and `HealthConnectRationaleActivity`.

## Two processes

The app runs in **main** and **`:napplet`**. Read `AGENTS.md` "Android Runtime Processes" before
touching `Amethyst.kt`, an Application callback, or anything under `napplet/`. The sandbox
activities and services (`NappletHostActivity`, `NappletBrowserActivity`, `NappletHostService`,
`NappletBrowserService`) live in the `:nappletHost` module and are declared with
`android:process=":napplet"`. The broker side (`napplet/NappletBrokerService.kt`,
`NappletLaunchRegistry`, consent) stays in `amethyst/`.

## Manifest and intents

`amethyst/src/main/AndroidManifest.xml`; each flavor merges its own `AndroidManifest.xml`.

- `MainActivity` takes `MAIN`, `VIEW` for `nostr:`, `amethyst:`, `nostrconnect:`, the
  wallet-connect schemes and several `https` hosts, and `SEND`.
- **Share targets are `<activity-alias>`es of MainActivity** (`.ui.ShareAsDMAlias`,
  `ShareAsPictureAlias`, `ShareAsShortVideoAlias`, `ShareAsVideoAlias`, `ShareAsHighlightAlias`,
  `ScanQrCodeAlias`). Which one the user picked is visible only in the launching intent's
  component class name, which `ShareIntentRouting.targetOf` in
  `commonsUI/.../commons/ui/navigation/ShareIntentRouting.kt` maps to a `ShareTarget`. Renaming an
  alias without updating its constant there silently routes the share to New Post. Adding a target
  means an alias, a constant, and a `ShareTarget` entry.
- `NavigateIfIntentRequested` (`ui/navigation/AppNavigation.kt`) turns `VIEW` / `SEND` /
  `SEND_MULTIPLE` / NFC intents into `nav.newStack(...)` calls.
- Foreground services (`CallForegroundService`, `NestForegroundService`, `PlaybackService`,
  `NotificationRelayService`, ...) read their notification strings synchronously, which is the one
  case where a string may stay in Android `res/`. See `AGENTS.md` "Strings" and
  `amethyst/src/main/res/AGENTS.md`.

## Intent / Context access from shared UI

Shared composables never touch `Context` directly. Use the existing shape: a small interface plus
an `expect fun rememberX()` in `commonsUI` `commonMain`, with the Android actual in
`commonsUI/src/androidMain`. Examples: `TextSharer` / `rememberTextSharer()` (the actual builds the
`ACTION_SEND` chooser from `LocalContext`), `FileSharer`, `PlatformBackHandler`,
`HideFromScreenshots`, `rememberCoarseLocationPermission(): PlatformPermission` (the actual wraps
Accompanist's `rememberPermissionState`). When the behavior needs app-only state (an Activity
class, a service, `Amethyst.instance`), put a member on `AppPlatform` / `AppServices` and implement
it in `AndroidAppPlatform` / `AndroidAppServices`, as `openNestRoom` does with `NestActivity.launch`.

## Flavors: play vs fdroid

`amethyst/build.gradle.kts` declares `flavorDimensions += "channel"` with `play` (default) and
`fdroid`. They differ in `BuildConfig.IS_CASTING_AVAILABLE` and in their dependencies:

- `play`: Firebase messaging, ML Kit (language id, translate, GenAI proofreading / rewriting /
  prompt / image description), Play Services Cast, androidx AppFunctions.
- `fdroid`: UnifiedPush and no Google services.

Classes that `main` calls exist in **both** `src/play/java/...` and `src/fdroid/java/...` with the
same name and signature (`PushNotificationUtils`, `SelectNotificationProvider`,
`LanguageTranslatorService`, `WritingAssistantFactory`, `ChromecastCaster`, `TermsGate`, ...). Add
or change one side and the other flavor stops compiling. Build both when you touch them. Play-only
code (`appfunctions/AmethystAppFunctions.kt`, `AmethystCastOptionsProvider`) needs no twin as long
as `main` never references it. Build types: `debug` (`.debug` suffix), `release`, and `benchmark`
(release config, debug-signed, profileable).

Gradle details beyond this (catalog, versions, KMP source sets) belong to `kotlin-multiplatform`.

## Images (Coil)

`service/images/ImageLoaderSetup.kt` installs the singleton Coil loader. It is called from
`AppModules.setImageLoader()` with a `callFactory` built from
`roleBasedHttpClientBuilder.okHttpClientForImage`, so Tor routing and the "image" traffic tag
apply. Change the client there, not inside the loader setup.
`BlossomFetcher` and `ProfilePictureFetcher` are Android-side. The shared fetchers
(`Base64Fetcher`, `BlurHashFetcher`, `ThumbHashFetcher`) are in
`commonsUI/.../commons/service/image/`, and the desktop counterpart is
`desktopApp/.../desktop/service/images/DesktopImageLoaderSetup.kt`. Never build an `ImageLoader`
inside a composable.

## R8 and release checks

The rules are `amethyst/proguard-rules.pro` plus `quartz/consumer-rules.pro`. The policy is to keep
only what is reached by name. Read `references/proguard-rules.md` before adding a keep.

R8 cannot see reflection, so a broken keep gives a green build and a crash on users' devices.
Before tagging a release, run the reflection-contract check on a minified build. A
`playBenchmark` build is enough, and `-PdisableAbiSplits=true` keeps it quick:

```bash
./gradlew :amethyst:assemblePlayBenchmark -PdisableAbiSplits=true
python3 tools/r8-verify/verify_reflection_contract.py amethyst/build/outputs/mapping/playBenchmark/
```

The release workflow (`.github/workflows/create-release.yml`) runs the same script on
`playRelease` and `fdroidRelease`. Adding reflection means adding a keep rule **and** a line in
`tools/r8-verify/reflection-contract.txt` (prefix it with `@play` / `@fdroid` for flavor-only
classes).

## Testing

Unit tests are in `amethyst/src/test` (plus `testPlay`), instrumented tests in
`amethyst/src/androidTest` (plus `androidTestPlay`). Before calling a UI change done, run it on a
device or emulator: `./gradlew :amethyst:installDebug`.
Pliki w paczce (2)
  • SKILL.md 7 KB
  • references/proguard-rules.md 10 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · vitorpamplona/amethyst100MIT
personamanagmentlayer/pcl100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 29911188b177 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100auth-signers
    Opisuje sygnatariuszy NostrSigner w Amethyst (klucz lokalny, bunker NIP-46, aplikacja Android NIP-55) przy podpisywaniu, szyfrowaniu, dodawaniu nowego rodzaju sygnatariusza i debugowaniu timeoutów.
  • 100jetpack-compose-expert
    Wspiera projekty natywnego Androida w Jetpack Compose (Kotlin 2.x): budowa ekranów, zarządzanie stanem, nawigacja, DI (Hilt), Room i testy z Material 3 oraz ViewModel i StateFlow.
  • 100android
    Rozwija natywne aplikacje Android w Kotlinie i Jetpack Compose, w tym pliki Gradle, ekrany Compose, R8 oraz wydajność przewijania.
  • 100android-design
    Buduje aplikacje na Androida w Compose, React Native, Flutter i Compose Multiplatform z Material 3, układami adaptacyjnymi i przygotowaniem pod Play Store.
  • 90react-native-fdroid-publish
    Prowadzi publikację aplikacji React Native lub Expo na F-Droid: usuwa Firebase i usługi Google, pisze recepty fdroiddata i odpowiada recenzentom.
  • 100desktop-expert
    Pomaga w pracy z desktopową powłoką JVM w katalogu desktopApp (AmethystDesktop, menu, porty platformowe, keyring systemowy) i uruchamia wspólne UI w trybie headless do weryfikacji zmian.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.