Guida completa all'immagine picker di Expo per il 2026

Probabilmente sei arrivato al punto in cui l'interfaccia utente è pronta, la schermata del profilo ha un pulsante "Carica foto" e ora la parte facile improvvisamente non è più facile. Il flusso di selezione dell'immagine tocca le autorizzazioni native, gli interfacce controllate dall'OS, le forme di ritorno diverse da quelle che molti sviluppatori si aspettano e un pugno di dettagli di build-time che si manifestano solo dopo aver distribuito un build reale.

Questa è dove entra in gioco l'immagine picker di Expo. È la libreria ufficiale di Expo per aprire l'interfaccia di sistema per scegliere immagini e video dalla libreria del dispositivo o scattare una foto con la fotocamera, come descritto nella repository del pacchetto Expo. In pratica, questo significa che ottenete un ponte affidabile per l'accesso ai dati di input nativi, ma non un'esperienza di media personalizzata che si comporta identicamente su ogni dispositivo.

Questa guida è scritta per la prima implementazione, non per il demo. Si concentra sulle decisioni che contano nella produzione: configurazione di setup di workflow gestito o nudo, gestione delle autorizzazioni che non vi sorprenderanno in seguito, parsing dei risultati sicuri, e un modello di caricamento pratico dopo che l'utente ha selezionato un file. Se lavorate in un setup nativo personalizzato, aiuta anche a capire come questo differisce da un Flusso di sviluppo del client di Expo.

Indice

• Avvio rapido con l'immagine picker di Expo
• Installazione e configurazione essenziale
  • Configurazione di setup di workflow gestito
  • Dettagli di setup di React Native nudo
• Accesso alla camera e alla libreria dei media
  • Un componente minimo ma sicuro
  • Flussi della libreria e della camera
  • Cosa aspettarsi dall'interfaccia utente del sistema
• Manipolazione dei risultati e delle opzioni del picker
  • Leggere correttamente l'oggetto di risultato
  • Opzioni che modificano il comportamento downstream
  • URI contro base64
  • Un modello di risultato più sicuro per le app reali
• Modelli avanzati e differenze tra piattaforme
  • Un modello di caricamento pratico
  • Dove le differenze tra piattaforme hanno effettivamente importanza
  • Differenze tra flussi di lavoro gestiti e non gestiti
• Risoluzione dei problemi comuni
  • Controlli veloci per fallimenti comuni
  • Un breve elenco di controllo di produzione

Inizia con Expo Image Picker

Un manager dei prodotti chiede foto di profilo. Una settimana dopo, la stessa funzionalità ha bisogno anche di caricamenti di ricevute, cattura di foto per i rapporti di incidente, e riprovini quando gli utenti negano la prima volta il permesso. L'input di immagini si espande rapidamente perché tocca le autorizzazioni native, l'interfaccia utente di sistema, la gestione dei file temporanei e le flussi di caricamento backend.

expo-image-picker è il modulo Expo SDK per quel lavoro. Apre il picker di piattaforma o l'interfaccia utente della fotocamera e restituisce i media selezionati in una forma che il tuo React Native code può gestire. Il JavaScript API è piccolo. Il principale ostacolo risiede nella configurazione nativa, nel flusso di autorizzazione e nella gestione dei risultati sia nei progetti gestiti che in quelli bare.

La principale trade-off è chiara. Lasci che iOS e Android presentino le loro interfacce di media al posto di costruire un picker personalizzato. Di solito ciò dà un risultato migliore: gli utenti già sanno cosa aspettarsi dalle schermate di sistema, le richieste di autorizzazione si comportano come si aspetta l'OS e il tuo team evita di mantenere un'implementazione di galleria in JavaScript.

Considera questo come una funzionalità di integrazione nativa con un'interfaccia React.

Questa mentalità aiuta perché i modi di fallimento sono raramente nel bottone che chiama il picker. Di solito vengono da uno dei tre posti:

• Configurazione nativa: impostazione del plugin mancante, stringhe di autorizzazione errate, o un build obsoleto dopo aver modificato la configurazione
• Comportamento di esecuzione: gli utenti possono negare l'accesso, concedere accesso limitato alla libreria su iOS, o annullare il flusso senza selezionare nulla
• Analisi dei risultati: il corrente API restituisce un assets array, quindi gli esempi più vecchi che leggono result.uri direttamente falliscono

La scelta del flusso di lavoro cambia anche il percorso di configurazione. In un'app Expo gestita, la maggior parte del lavoro nativo vive nella configurazione dell'app e richiede una ricompilazione quando quella configurazione cambia. In un'app bare, si ottiene ancora il modulo Expo API, ma è necessario verificare le impostazioni dei progetti iOS e Android sottostanti in modo più diretto. Se il tuo team sta utilizzando un client personalizzato invece di Expo Go, questa guida si abbina bene con l'Capgo’s spiegazione di come un client di sviluppo Expo cambia il testing dei moduli nativi.

Quel split è importante per il resto della guida perché il percorso felice è solo la metà della storia. Una implementazione di picker è solida quando funziona in entrambi i flussi di lavoro, gestisce le stranezze di autorizzazione specifiche della piattaforma senza sorprendere l'utente e passa un file utilizzabile al layer di upload invece di fermarsi a unaantevisione locale.

Installazione e Configurazione Essenziale

L'installazione richiede un solo comando. Ottenere la configurazione nativa giusta è ciò che determina se il picker funziona su un dispositivo reale, in un client di sviluppo personalizzato e nel tuo build di produzione.

expo-image-picker fornisce un API React-facing sui picker delle piattaforme per le foto, i video e la cattura della fotocamera. La chiamata JavaScript è semplice. La configurazione non lo è, perché l'accesso alle foto e la cattura della fotocamera sono controllati da iOS e Android, non da React Native.

Inizia con l'installatore versione-aware di Expo:

npx expo install expo-image-picker

Usa expo install invece di npm install o yarn add. Expo sincronizza la versione del pacchetto con il tuo SDK, evitando così un comune insieme di problemi di compatibilità nativi. Se stai confrontando come i moduli Expo si integrano nel tuo processo di rilascio, questo Panoramica degli strumenti Expo è una utile riferimento.

Configurazione del flusso gestito

Nel flusso gestito, dichiara il plugin nella configurazione dell'applicazione in modo che Expo possa applicare le modifiche native al momento della compilazione.

Esempio con app.json:

{
  "expo": {
    "plugins": ["expo-image-picker"]
  }
}

Questo è il minimo impostato. In pratica, gli squadre aggiungono di solito il testo delle autorizzazioni e soprattutto su iOS, dove la richiesta di sistema dovrebbe spiegare perché l'app necessita di accesso. Mantieni il testo specifico all'azione dell'utente. 'Carica una foto di profilo' è meglio di 'Necessità di accesso ai media.'

Un dettaglio operativo causa molto tempo perso. Cambiare pluginsstringhe di autorizzazione o altre configurazioni native richiede una ricompilazione. Caricare JavaScript non applica quelle modifiche. In Expo Go, sei anche limitato da cosa il client già include. In un build di sviluppo o in un build di produzione, il progetto nativo riflette la tua configurazione solo dopo una nuova compilazione.

Dettagli sulla configurazione di React Native senza pacchetti

In un'app bare, il pacchetto API è lo stesso, ma devi verificare più del progetto nativo da solo. Le descrizioni di utilizzo di iOS sono la prima cosa da controllare. Se il tuo flusso può aprire la libreria, avviare la fotocamera o registrare video con audio, la tua app necessita delle stringhe di autorizzazione corrispondenti in Info.plist Prima di ricostruire.

Un elenco pratico per progetti senza bare si presenta così:

1. Installa expo-image-picker con npx expo install expo-image-picker.
2. Aggiungi la configurazione del plugin se il tuo progetto utilizza plugin di configurazione Expo.
3. Conferma che le descrizioni di utilizzo per iOS corrispondono alle funzionalità che esponi.
4. Ricostruisci le app di iOS e Android dopo qualsiasi cambiamento nella configurazione nativa.

Il testo delle autorizzazioni mancanti spesso si presenta come un bug di esecuzione perché l'interfaccia utente code è funzionale e il gestore del pulsante viene eseguito. Il fallimento si trova più in basso nella pila. Di solito controlli Info.plist, la configurazione dell'app e se l'ultima build include le modifiche native più recenti prima di toccare il componente code.

Alcune abitudini rendono la configurazione più prevedibile:

• Scrivi il testo delle autorizzazioni per l'azione effettiva: gli utenti dovrebbero capire perché vedono la richiesta.
• Configura la telecamera e la libreria separatamente: Uno può funzionare mentre l'altro fallisce ancora.
• Riavvia dopo le modifiche native: La ricarica calda e la rinfrescata veloce non aggiornano le autorizzazioni native.
• Testa sul dispositivo: Il comportamento del simulatore può nascondere problemi di autorizzazione e telecamera.

Se il picker funziona durante lo sviluppo ma si rompe in TestFlight o nella versione per il Play Store, consideralo un problema di configurazione in primo luogo. La maggior parte delle volte, è così.

Accesso alla Telecamera e alla Libreria dei Media

Un utente clicca su “Carica foto”, si aspetta che la telecamera o la libreria si aprano, e il tuo app ha un solo compito in quel momento. Apri la GUI di sistema giusta, gestisci la rifiutazione o la cancellazione senza rompere lo schermo e restituisci un riferimento di file locale utilizzabile per la visualizzazione o l'invio.

Suona semplice fino a quando non testi sia le build gestite che quelle bare su iOS e Android. Il JavaScript API rimane compatto, ma il comportamento di esecuzione ancora dipende dalle richieste di OS, dal hardware del dispositivo e da come le autorizzazioni native sono state configurate in precedenza.

Un componente minimo ma sicuro

The core flow è coerente in entrambi i progetti di workflow Expo gestiti e non gestiti. Richiedere la relativa autorizzazione, avviare il picker, verificare se l'utente ha annullato, quindi leggere il primo asset da result.assets.

Un componente di base assomiglia a questo:

import { useState } from 'react';
import { View, Button, Image, Alert } from 'react-native';
import * as ImagePicker from 'expo-image-picker';

export default function PhotoInput() {
  const [imageUri, setImageUri] = useState<string | null>(null);

  const pickFromLibrary = async () => {
    const permission = await ImagePicker.requestMediaLibraryPermissionsAsync();

    if (!permission.granted) {
      Alert.alert('Permission required', 'Please allow photo library access.');
      return;
    }

    const result = await ImagePicker.launchImageLibraryAsync({
      mediaTypes: ['images'],
      allowsEditing: true,
      quality: 1,
    });

    if (result.canceled) return;

    const asset = result.assets?.[0];
    if (!asset?.uri) return;

    setImageUri(asset.uri);
  };

  const takePhoto = async () => {
    const permission = await ImagePicker.requestCameraPermissionsAsync();

    if (!permission.granted) {
      Alert.alert('Permission required', 'Please allow camera access.');
      return;
    }

    const result = await ImagePicker.launchCameraAsync({
      allowsEditing: true,
      quality: 1,
    });

    if (result.canceled) return;

    const asset = result.assets?.[0];
    if (!asset?.uri) return;

    setImageUri(asset.uri);
  };

  return (
    <View>
      <Button title="Choose from library" onPress={pickFromLibrary} />
      <Button title="Take photo" onPress={takePhoto} />
      {imageUri ? (
        <Image
          source={{ uri: imageUri }}
          style={{ width: 200, height: 200 }}
        />
      ) : null}
    </View>
  );
}

Tre dettagli sono importanti qui.

• Richiedere le autorizzazioni della libreria e della fotocamera separatamente. Falliscono independentemente.
• Trattare l'annullamento come un'azione normale dell'utente, non uno stato di errore.
• Leggi da assets[0], perché il picker restituisce un array di asset anziché un livello superiore uri.

Flussi della libreria e della fotocamera

Inizia con il flusso della libreria se desideri la strada più veloce per una funzionalità funzionante. È più facile da testare, funziona in più impostazioni di simulatore e evita i casi di bordo del hardware della fotocamera. Aggiungi il supporto della fotocamera una volta stabilito il percorso di gestione dei risultati.

Il percorso della fotocamera ha più modi per fallire in fase di sviluppo. Il supporto per il simulatore iOS è limitato. Gli emulatori Android possono non esporre il comportamento della fotocamera che corrisponde a un dispositivo reale. In progetti non gestiti, quelle lacune possono farvi cercare il componente code anche se il problema reale è la configurazione nativa o l'ambiente di test.

Un pattern di interfaccia utente pulito è chiedere all'utente la fonte prima di chiamare il picker API:

const showPickerOptions = () => {
  Alert.alert('Upload image', 'Choose a source', [
    { text: 'Camera', onPress: takePhoto },
    { text: 'Photo Library', onPress: pickFromLibrary },
    { text: 'Cancel', style: 'cancel' },
  ]);
};

Quella separazione mantiene ogni funzione focalizzata. Inoltre, rende più facile aggiungere analisi, flag di funzionalità o regole specifiche del backend in un secondo momento. Ad esempio, alcune squadre consentono gli upload della libreria per le immagini del profilo, ma richiedono catture della fotocamera fresche per la verifica dell'identità.

If il tuo'applicazione più ampia supporta anche modelli di accesso ai file esterni a Expo o stai confrontando convenzioni tra stack nativi, questo Capacitor riferimento alla libreria delle foto è utile contesto.

Eseguire un breve demo è utile quando mostri questo flusso ai tuoi colleghi o QA:

Cosa aspettarsi dall'interfaccia utente del sistema

expo-image-picker apre il picker di piattaforma o l'interfaccia dell'utenza. La tua app non controlla ogni schermo in quel flusso. Quella distinzione è importante perché 'funziona sul mio dispositivo' spesso significa 'l'OS ha consentito il percorso che ho testato.'

Sui dispositivi iOS, gli utenti possono concedere accesso limitato alla libreria invece di un accesso completo. Sui dispositivi Android, il comportamento del picker può variare in base alla versione del sistema operativo e alla pelle del fornitore. Nei progetti di workflow gestiti, Expo gestisce più della connessione nativa per te. Nei progetti di workflow nudo, devi confermare che la tua app costruita include le modifiche alle autorizzazioni native che hai fatto. Il sito di chiamata JavaScript può essere identico in entrambi i casi mentre l'esito in esecuzione differisce.

Di solito testo questi casi prima di chiamare la funzione completa:

• prima richiesta di autorizzazione
• denegata autorizzazione
• annullamento dell'utente
• selezione della libreria riuscita
• cattura di camera fisica riuscita
• anteprima immediata dell'URI locale restituito

Quei casi si mappano direttamente al comportamento di produzione reale. Inoltre, configurano il passo successivo in modo pulito se hai bisogno di inviare il file a un server, a una pipeline di moderazione o a un endpoint di pubblicazione come il Pubblicazione dei media di Instagram API.

Gestione dei risultati e delle opzioni del picker

Il risultato del picker è la parte che solitamente richiede logica di produzione reale. L'interfaccia utente del sistema restituisce un oggetto strutturato, non solo un percorso del file, e piccoli errori qui portano a anteprime rotte, upload vuoti o crash dopo che l'utente annulla.

Lettura dell'oggetto di risultato correttamente

La forma del risultato che interessa nelle attuali applicazioni Expo è result.assets[0].urinon un livello superiore result.uriQuel dettaglio influenza sia i progetti di workflow gestiti che quelli bare perché lo script JavaScript API è lo stesso anche se la configurazione nativa differisce sotto.

Usa un pattern guard-first:

const result = await ImagePicker.launchImageLibraryAsync({
  mediaTypes: ['images'],
  allowsEditing: true,
  quality: 1,
});

if (result.canceled) {
  return;
}

const asset = result.assets?.[0];
if (!asset) {
  return;
}

const { uri } = asset;
setImageUri(uri);

Questo gestisce i due casi di fallimento che vedo più spesso. Un picker annullato non ti dà un asset da leggere, e code che assume result.assets[0] sempre esiste e fallirà all'esecuzione.

Una volta che hai la URI, la visualizzazione di un anteprima è facile:

<Image source={{ uri: imageUri }} style={{ width: 240, height: 240 }} />

Se hai l'intenzione di caricare in seguito, conserva l'intero asset oggetto, non solo la URI. In pratica, fileName, mimeType, width, heighte fileSize sono spesso utili per la validazione, il logging o la creazione di una richiesta multipart più pulita.

Le opzioni che modificano il comportamento a valle

Alcune opzioni del picker influiscono su più di solo la schermata di selezione. Modificano la dimensione del file, il comportamento di modifica e cosa il tuo backend deve accettare.

A pochi compromessi si rischia di non accorgersi:

• allowsEditing è utile quando lo slot dell'immagine ha una forma o dimensione fisse. È meno utile se il tuo server gestisce il proprio pipeline di taglio e vuoi il file originale.
• quality influisce sul tempo di caricamento, sulla pressione di memoria e sullo storage del server. quality: 1 non è automaticamente la scelta giusta.
• mediaTypes dovrebbe corrispondere alle regole del backend. Se il server rifiuta i video, non lasciare che il picker li restituisca.
• base64 aumenta la dimensione del payload in memoria. Evitalo a meno che il servizio di ricezione non lo richieda.

Quel punto è importante sui dispositivi con memoria inferiore. Un URI di file locale è di solito la scelta migliore per la preview e l'upload multipart. Base64 ha usi validi, ma è costoso rispetto a passare una referenza di file.

URI versus base64

Per la maggior parte degli app, la regola è semplice:

• Usa URI per le anteprime.
• Usa URI per caricare file.
• Usa base64 solo quando il sistema di destinazione chiede esplicitamente contenuto codificato.

Quel pattern mantiene il picker code piccolo e più facile da testare. Inoltre, si allinea con la maggior parte delle flussi di media backend, compresi i servizi che pubblicano eventualmente su piattaforme esterne come il pubblicazione dei media di Instagram API.

Se il tuo team invia aggiornamenti OTA frequenti o sposta asset immagine pesanti attraverso la consegna dell'applicazione, le decisioni sui file dimensioni qui hanno un impatto sul resto della pipeline. Questa guida su l'ottimizzazione delle immagini per gli aggiornamenti dell'applicazione è un utile compagno di configurazione del picker.

Un pattern di risultato più sicuro per le app reali

For demo code, archivia solo imageUri è sufficiente. In produzione, archivia un oggetto normalizzato in modo che il prossimo passo, anteprima, validazione, caricamento o riprova, non debba reinterpretare la risposta del picker raw ogni volta.

const result = await ImagePicker.launchImageLibraryAsync({
  mediaTypes: ['images'],
  allowsEditing: true,
  quality: 0.8,
});

if (result.canceled || !result.assets?.length) {
  return;
}

const asset = result.assets[0];

setSelectedImage({
  uri: asset.uri,
  fileName: asset.fileName ?? 'upload.jpg',
  mimeType: asset.mimeType ?? 'image/jpeg',
  width: asset.width,
  height: asset.height,
  fileSize: asset.fileSize ?? null,
});

Questo ti da una forma prevedibile all'interno dell'app. Ciò rende anche i progetti gestiti e bare più facili da tenere allineati perché l'app code rimane stabile mentre lavori attraverso le differenze native altrove.

Un ultimo controllo aiuta. Non abilitare i campi di risultato aggiuntivi solo per precauzione. Richiedi i dati che sai di dover avere, e mantieni il picker focalizzato sulla selezione piuttosto che trasformarlo in un passo di elaborazione generale dei file.

Modelli avanzati e differenze di piattaforma

Un feature picker di solito smette di essere semplice non appena l'immagine selezionata deve sopravvivere alle riprova, ai capi di autenticazione, alle differenze di autorizzazione native e a un endpoint di caricamento reale. expo-image-picker gestisce la selezione bene. Il resto della feature è a carico dell'app.

Un modello di caricamento pratico

Per API che aspettano un caricamento di file, FormData è ancora il default più sicuro. Funziona su backends comuni di Rails, Node, Laravel, Django e Go, e mantiene il picker separato dalle preoccupazioni di trasporto.

async function uploadImage(imageUri: string) {
  const formData = new FormData();

  formData.append('file', {
    uri: imageUri,
    name: 'upload.jpg',
    type: 'image/jpeg',
  } as any);

  const response = await fetch('https://your-api.example.com/uploads', {
    method: 'POST',
    body: formData,
    headers: {
      Accept: 'application/json',
    },
  });

  if (!response.ok) {
    throw new Error('Upload failed');
  }

  return response.json();
}

Quel code è sufficiente per dimostrare che il percorso funziona, ma le app di produzione solitamente hanno bisogno di un'altra layer. Deriva name e da un oggetto selezionato quando possibile, attacca l'autenticazione all'esterno della funzione del picker e mantiene lo stato di caricamento separato dallo stato del picker in modo che una richiesta fallita non costringa l'utente a riaprire la libreria. type Un paio di controlli prevenire le comuni fallite che vedo in revisione:

Conferma la versione locale

• esiste prima di costruire la richiesta uri Visualizza un anteprima prima di caricare in modo che gli utenti individuino il file sbagliato presto
• Prevenire i tocchi ripetuti mentre la richiesta è in volo
• Gestisci le fallite di rete separatamente dalla cancellazione del picker o dagli errori di autorizzazione
• Aspetta che la validazione del backend respinga i file troppo grandi, i tipi MIME non supportati o la mancanza di autenticazione
• Se il tuo backend richiede base64 invece di multipart, è di solito una restrizione del server, non una richiesta del picker. Multipart è più economico in termini di memoria e più facile da ragionare su dispositivi mobili.

Dove le differenze tra piattaforme hanno effettivamente importanza

L'interfaccia del picker è nativa, quindi eredita il comportamento nativo. Ciò influenza sia cosa gli utenti vedono sia cosa il tuo __CAPGO_KEEP_0__ dovrebbe assumere.

code

On iOS, le flussi di modifica e le richieste di autorizzazione seguono le convenzioni di Apple. L'accesso alle foto è limitato può restituire un insieme più ristretto di asset rispetto a quanto visto nel tuo account di test su un dispositivo con accesso pieno. Su Android, il comportamento del picker varia più a seconda della versione del sistema operativo e della pelle del produttore, soprattutto intorno agli album, ai nomi dei file e a come le catture della fotocamera sono restituite. Le app React Native nate con React Native sentono queste differenze più direttamente perché si possiede più della configurazione nativa, ma le app Expo gestite ancora hanno bisogno di code che tratta il picker come piattaforma-orientato piuttosto che perfettamente uniforme.

La regola pratica è semplice. Dipendi dai campi che puoi validare, non dal UI identico o dai metadati identici tra dispositivi.

Un paio di esempi conta in app reali:

• Modifica e taglio: La UI e il comportamento di taglio non sono identici tra iOS e Android
• Il metadati restituiti: fileName, mimeType, e fileSize possono essere assenti o inconsistenti, quindi aggiungi fallback
• I permessi: L'accesso alle foto di iOS può essere limitato agli elementi selezionati, mentre il comportamento di Android dipende più dalla versione del sistema operativo e dal supporto del picker del sistema
• L'uscita della fotocamera: Le immagini catturate possono tornare con caratteristiche di denominazione, orientamento o compressione diverse rispetto agli asset della libreria

If il tuo team lavora anche al di fuori di Expo, questo Guida allo sviluppo di app DesignStack fornisce un contesto utile per le decisioni di gestione dei media Android che si manifestano al di là di una singola libreria.

Differenze tra flussi di lavoro gestiti e bare

A questo punto, le scelte di configurazione iniziano a contare operativamente.

Nel flusso di lavoro gestito, le stringhe di autorizzazione e la configurazione dei plugin vivono di solito nella configurazione dell'app, e le modifiche native vengono applicate quando si crea una nuova build. Ciò mantiene la superficie di JavaScript pulita, ma significa che una correzione di configurazione non è visibile fino alla prossima build nativa. Le aggiornamenti OTA non riparano le autorizzazioni native mancanti.

Nel flusso di lavoro bare, la stessa funzionalità ha più parti in movimento. È necessario verificare le descrizioni di utilizzo iOS native, il comportamento del manifesto Android, l'installazione del pacchetto e la sincronizzazione del rebuild da parte del team.

Teams that switch between Expo and Capacitor often underestimate how different these abstraction layers are. Capgo has a useful explanation of Il team che passa tra Expo e Capacitor spesso sottovaluta quanto siano diversi questi layer di astrazione. __CAPGO_KEEP_1__ ha una spiegazione utile dicome __CAPGO_KEEP_0__ gestisce le differenze tra piattaforme

My preference is consistent across both workflows. Keep picker code narrow, normalize the result once, upload through a dedicated API layer, and treat platform-specific behavior as something to configure and test explicitly rather than smooth over with assumptions.

La mia preferenza è coerente in entrambi i flussi di lavoro. Mantieni il picker __CAPGO_KEEP_0__ stretto, normalizza il risultato una volta, caricalo attraverso un layer __CAPGO_KEEP_1__ dedicato, e trattalo come qualcosa da configurare e testare esplicitamente piuttosto che smooth over con ipotesi.

La maggior parte dei bug di Expo Image Picker appartiene a una piccola serie di categorie. La soluzione più veloce è di solito identificare quale layer sta fallendo: configurazione, autorizzazione, gestione del risultato o rendering.

Controlli veloci per fallimenti comuni

Se il picker non si apre o le autorizzazioni falliscono, controlla la configurazione nativa prima di tutto. In particolare, gli app bare, mancanti le descrizioni di utilizzo iOS sono una causa comune di base.

Se l'app si blocca dopo che l'utente chiude il picker, controlla la gestione del risultato. Molti implementazioni ancora assumono una URI diretta e saltano il canceled check.

Un paio di rapide mappature aiutano:

• Errori di autorizzazione negata: Verifica la configurazione dell'app e le stringhe di autorizzazione native, quindi ricostruisci.
• undefined URI dell'immagine: Leggi da result.assets?.[0]?.uri, non result.uri.
• Niente accade dopo l'annullamento: Potrebbe essere corretto. Tratta l'annullamento come uno stato senza effetti.
• L'immagine non si visualizza: Conferma che l'URI è stato memorizzato nello stato e passato in <Image source={{ uri }} />.
• La fotocamera funziona in modo strano nel simulatore: Testa sul dispositivo fisico prima di cercare di risolvere un bug di librerie.

Checklist di produzione breve

Usa questo come passaggio finale prima di distribuire:

• Installa con Expo tooling: Usa npx expo install expo-image-picker.
• Configura le parti native: Aggiungi la descrizione del plugin e delle autorizzazioni richieste.
• Richiedi le autorizzazioni in modo intenzionale: Separare i flussi della fotocamera e della libreria dei media.
• Guarda ogni risultato: Controlla result.canceled e leggi in modo sicuro assets[0].
• Preferisci le upload basate su URI: Mantieni base64 solo per casi speciali.
• Testa dispositivi reali: Soprattutto per la cattura della fotocamera e le richieste di autorizzazione.

Se il tuo team distribuisce Capacitor o app Electron insieme ai progetti React Native, Capgo è un'opzione per consegnare aggiornamenti JavaScript, CSS, configurazione e risorse senza dover attendere la revisione della store per ogni modifica. È rilevante quando si risolvono problemi di immagine nel layer web, come l'interfaccia di caricamento, le regole di validazione, la copia o il trattamento delle risorse intorno al flusso del picker.