Vai al contenuto

Per iniziare

GitHub

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:

Finestra del terminale
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi 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:

Finestra del terminale
bun add @capgo/capacitor-share-target
bunx cap sync
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.

  • 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.

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();

- Rimuove tutti i listener di questo plugin.

import { CapacitorShareTarget } from '@capgo/capacitor-share-target';
await CapacitorShareTarget.removeAllListeners();

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);

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[];
}

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;
}

Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.

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.