native-module

Guide Création Module Natif React Native

Tu es un développeur React Native senior. Tu dois guider la création d'un module natif (bridge) pour iOS et Android.

Arguments

$ARGUMENTS

Arguments :

• Nom du module (ex: DeviceInfo, Biometrics, FileManager)
• (Optionnel) Fonctionnalités : sync, async, events

Exemple : /reactnative:native-module Biometrics async,events

MISSION

Étape 1 : Structure du Module

src/
└── native/
    └── {ModuleName}/
        ├── index.ts          # API JavaScript
        ├── types.ts          # Types TypeScript
        └── NativeModule.ts   # Bridge avec TurboModule

android/
└── app/src/main/java/com/{package}/
    └── {modulename}/
        ├── {ModuleName}Module.kt      # Module principal
        └── {ModuleName}Package.kt     # Package registration

ios/
└── {AppName}/
    ├── {ModuleName}.swift             # Module Swift
    └── {ModuleName}-Bridging-Header.h # Header pour Obj-C bridge

Étape 2 : API JavaScript/TypeScript

// src/native/{ModuleName}/types.ts
export interface {ModuleName}Result {
  success: boolean;
  data?: unknown;
  error?: string;
}

export interface {ModuleName}Options {
  timeout?: number;
  // ...autres options
}

export type {ModuleName}EventType = 'onProgress' | 'onComplete' | 'onError';

export interface {ModuleName}Event {
  type: {ModuleName}EventType;
  payload: unknown;
}

// src/specs/Native{ModuleName}.ts  ← Codegen spec (New Architecture RN 0.85+)
import type { TurboModule } from 'react-native';
import { TurboModuleRegistry } from 'react-native';

// Codegen génère les bindings C++/ObjC/Java à partir de cette spec TypeScript.
// Exécuter `pod install` (iOS) ou `./gradlew generateCodegenArtifacts` (Android)
// après toute modification de cette interface.
export interface Spec extends TurboModule {
  // Méthode synchrone via JSI (réserver aux opérations < 1 ms)
  getConstant(): string;

  // Méthodes asynchrones
  authenticate(options: {[key: string]: unknown}): Promise<{[key: string]: unknown}>;
  isSupported(): Promise<boolean>;

  // Événements (Fabric EventEmitter)
  addListener(eventType: string): void;
  removeListeners(count: number): void;
}

// TurboModuleRegistry.getEnforcing lève une erreur claire si le module
// n'est pas lié — remplace l'ancien pattern NativeModules.{ModuleName} + Proxy.
export default TurboModuleRegistry.getEnforcing<Spec>('{ModuleName}');