Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

native-integration

/native-integration

Przegląda pracę nad natywnymi modułami React Native, uprawnieniami i zadaniami w tle: integracje API platformy, kamera, biometria, pliki oraz granica mostu lub Turbo Module.

Licencja
MIT
Ostatnia zmiana repozytorium
29.09.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 29.09.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

Przegląda pracę nad natywnymi modułami React Native, uprawnieniami i zadaniami w tle: integracje API platformy, kamera, biometria, pliki oraz granica mostu lub Turbo Module.

Oryginalny opis (EN)

Review React Native native-module, permission, and background-task work. Use when integrating platform APIs, camera, biometrics, files, or reviewing a bridge or Turbo Module boundary.

Jak działa

  1. Applicability
  2. When to Use
  3. Severity
  4. Guidance
  5. Anti-Patterns
  6. Pitfalls
Sekcje z nagłówków SKILL.md, w oryginale · 89 linii, 680 słów
Podgląd SKILL.md
---
name: native-integration
description: Review React Native native-module, permission, and background-task work. Use when integrating platform APIs, camera, biometrics, files, or reviewing a bridge or Turbo Module boundary.
version: 1.1.0
platforms: [ios, android]
react-native-version: 0.76+
tags: [react-native, native, permissions, turbo-modules]
---

# Native Integration Skill

## Applicability

- **Platforms:** iOS and Android
- **React Native:** 0.76+ (New Architecture interop assumed unless a checklist item says otherwise)

## When to Use

- Integrating a native module, Turbo Module, or platform API
- Requesting permissions, or handling camera, biometrics, files, or location
- Adding a background task or a native listener
- Reviewing a change that crosses the JavaScript and native boundary

## Severity

- **Merge-blocking:** a permission prompt this diff adds loops after denial, or a listener this diff adds is not removed on unmount.
- **Should-fix:** usage-string wording and when the prompt appears, as long as denial does not crash.

## Guidance

### Permissions

This skill owns when the prompt is shown and what denial looks like. Analytics consent is owned by [security](../security/SKILL.md).

- [ ] Permission is requested at the moment of use, not on app launch or screen mount
- [ ] Denied, restricted, and revoked states have a path that does not crash or loop the prompt
- [ ] The user can continue without the permission, or is told what is blocked and how to enable it in Settings
- [ ] iOS usage strings explain the specific purpose; Android declares only the permissions the feature uses

**Incorrect:**
```tsx
useEffect(() => {
  requestCameraPermission();
}, []);
```

**Correct:**
```tsx
async function onTakePhoto() {
  const status = await getCameraPermission();
  if (status === 'denied') {
    const next = await requestCameraPermission();
    if (next !== 'granted') {
      setNeedsSettings(true);
      return;
    }
  }
  if (status === 'blocked') {
    setNeedsSettings(true);
    return;
  }
  await openCamera();
}
```

### Native boundary

- [ ] The JavaScript API returns a result or a typed error; it does not throw an unstructured native exception into the screen
- [ ] A missing or old native implementation has a fallback (hide the feature, or use a supported path)
- [ ] Values crossing the bridge are serialisable; functions, class instances, and cyclic objects are not passed through
- [ ] Platform differences are explicit (`Platform.OS` or separate files), not assumed to match
- [ ] New Architecture interop is used when the app is on the New Architecture; the old bridge is not added for a new module without a reason

### Lifecycle

- [ ] Native listeners, sensors, and subscriptions are removed on unmount
- [ ] Background work respects OS limits (time, network, and user-visible purpose) and can be cancelled
- [ ] Work that must finish (upload, payment) is confirmed on the server, not only by a native callback
- [ ] Native UI that presents a modal or activity restores the React Native screen when it dismisses

## Anti-Patterns

| Anti-Pattern | Risk | Fix |
|---|---|---|
| Requesting permission in `useEffect` on mount | Prompt before the user understands why; denial with no recovery | Request from the action that needs it, and handle denial |
| Treating "granted once" as permanent | Revoked or limited permission crashes the next call | Check status before every use |
| Passing a JS callback object into native and never removing it | Leak and calls after unmount | Subscribe with a cleanup function |
| Swallowing native errors as `catch {}` | The screen looks idle while the feature failed | Surface a typed error and a retry or fallback |

## Pitfalls

- Android may deliver a permission result after the activity restarts. Do not assume the component that called `request` is still mounted.
- iOS limited photo access is not the same as full access. Handle the limited set instead of treating it as denied or granted.
- Biometric success proves the device unlocked a key; it does not by itself prove the server accepted the user. Confirm the session server-side.
- A native module that touches UI or sensors must run on the platform's main thread. A background-thread call can crash or silently drop the event.
- File URIs from the camera or picker are often temporary. Copy what you must keep, and do not log the path if it contains user content.

Wersje

W bazie nie ma innych skilli o nazwie native-integration.

Migawka bazy z 13.11.2026 · wersja paczki f9f30fe5a9f0 (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

  • 100native-module-helper
    Tworzy własne natywne moduły React Native dla iOS i Androida do integracji SDK, kodu krytycznego wydajnościowo i dostępu do API platformy.
  • 95react-native-native-modules
    Pomaga tworzyć i integrować moduły natywne w React Native: Turbo Modules, mostkowanie kodu natywnego i dostęp do API platform.
  • 100vercel-react-native-skills
    Podpowiada dobre praktyki React Native i Expo: wydajne listy, animacje i praca z modułami natywnymi.
  • 100react-native-architecture
    Buduje produkcyjne aplikacje React Native z Expo, nawigacją, natywnymi modułami i synchronizacją offline oraz wzorcami wieloplatformowymi.
  • 95react-native-architecture
    Projektuje aplikacje mobilne w React Native z Expo: nawigacją, natywnymi modułami, synchronizacją offline i wzorcami wieloplatformowymi.
  • 90react-native
    Pomaga budować natywne aplikacje mobilne w React Native: komponenty, gesty, animacje i API platformy.

Uwagi i zgłoszenia

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