Per iniziare
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-share-target`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/share-target/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi usa il seguente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-share-target` plugin in my project.Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:
bun add @capgo/capacitor-share-targetbunx cap syncImporta
Sezione intitolata “Import”import { CapacitorShareTarget } from '@capgo/capacitor-share-target';Ascolta in anticipo (cold start)
Sezione: “Ascolto anticipato (cold start)”Registrati shareReceived non appena l'app si avvia, prima di indirizzare gli utenti verso le schermate che consumano i contenuti condivisi. Su iOS, il layer nativo mantiene l'evento finché JavaScript non lo consuma, coprendo così le condivisioni che arrivano mentre la WebView è ancora in fase di avvio.
import { CapacitorShareTarget } from '@capgo/capacitor-share-target';
const shareListener = await CapacitorShareTarget.addListener('shareReceived', (event) => { routeSharedPayload(event.title, event.texts, event.files);});
// When tearing down the handler:await shareListener.remove();Configura appGroupId nella capacitor.config e usa lo stesso App Group nella tua Share Extension. Consulta il README del plugin su GitHub per l'esempio di estensione code.
Errori comuni
Sezione intitolata “Errori comuni”- Configurazione nativa: intents only work after manifest and Xcode steps in the README.
- Cold start: bufferizza le condivisioni finché il router non è pronto.
- URI dei file: copia nello storage dell'app prima dell'upload, l'accesso potrebbe scadere.
Panoramica API
Sezione intitolata “Panoramica API”addListener
Sezione intitolata “addListener”Ascolta l'evento shareReceived.
Registra un listener che verrà chiamato quando un contenuto viene condiviso con l'app da un'altra app. Il callback riceve i dati dell'evento con titolo, testi e file.
import { CapacitorShareTarget } from '@capgo/capacitor-share-target';
const listener = await CapacitorShareTarget.addListener('shareReceived', (event) => { console.log('Title:', event.title); console.log('Texts:', event.texts); event.files?.forEach(file => { console.log(`File: ${file.name} (${file.mimeType})`); });});
// To remove the listener:await listener.remove();removeAllListeners
Sezione intitolata “removeAllListeners”- Rimuove tutti i listener di questo plugin.
import { CapacitorShareTarget } from '@capgo/capacitor-share-target';
await CapacitorShareTarget.removeAllListeners();getPluginVersion
Sezione intitolata “getPluginVersion”Ottieni la versione nativa del plugin Capacitor.
Restituisce la versione corrente dell'implementazione del plugin nativo.
import { CapacitorShareTarget } from '@capgo/capacitor-share-target';
const { version} = await CapacitorShareTarget.getPluginVersion();console.log('Plugin version:', version);Riferimento ai tipi
Sezione: “Type Reference”ShareReceivedEvent
Sezione intitolata “ShareReceivedEvent”Dati dell'evento ricevuti quando il contenuto viene condiviso con l'app.
export interface ShareReceivedEvent { /** * The title of the shared content. * * @since 0.1.0 */ title: string;
/** * Array of text content shared to the application. * * @since 0.1.0 */ texts: string[];
/** * Array of files shared to the application. * * @since 0.2.0 */ files: SharedFile[];}SharedFile
Sezione intitolata “SharedFile”Rappresenta un file condiviso con l'app.
export interface SharedFile { /** * The URI of the shared file. On Android/iOS this will be a file path or data URL. * On web this will be a cached URL accessible via fetch. * * @since 0.1.0 */ uri: string;
/** * The name of the shared file, with or without extension. * * @since 0.1.0 */ name: string;
/** * The MIME type of the shared file. * * @since 0.1.0 */ mimeType: string;}Fonte di verità
Sezione intitolata “Fonte di verità”Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.
Continua da Getting Started
Sezione intitolata “Continua da Getting Started”Se stai usando Per iniziare per pianificare le operazioni della dashboard e di API, collegalo a Utilizzo di @capgo/capacitor-share-target per la funzionalità nativa in Utilizzo di @capgo/capacitor-share-target, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione in Chiavi API, e Dispositivi per i dettagli di implementazione in Dispositivi.