Guida
Come usare App Intents in Capacitor
Utilizzo di @capgo/capacitor-app-intents
Interfaccia del plugin Capgo App Intents.
Installa
bun add @capgo/capacitor-app-intents
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
API in breve
| Metodo | Descrizione |
|---|---|
getPendingInvocations |
Restituisce le invocazioni messe in coda prima che JavaScript fosse pronto. |
removePendingInvocation |
Rimuovi un'invocazione in sospeso dopo che il tuo handler l'ha elaborata. |
setEntityCatalog |
Persisti un catalogo di entità per una determinata stringa di tipo. |
setHomeScreenShortcutItems |
Sostituisci le quick actions della Home Screen (UIApplicationShortcutItems). |
indexSpotlightEntities |
Indicizza gli elementi Spotlight per il dominio della tua app. |
removeSpotlightEntities |
Rimuovi gli elementi Spotlight tramite ID. |
performAppleSchemaTemplate |
Metti in coda un handler JavaScript per un template di schema Apple alpha. |
Esempi
getPendingInvocations()
Restituisce le invocazioni messe in coda prima che JavaScript fosse pronto.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
const result = await CapgoAppIntents.getPendingInvocations();
console.log(result);
removePendingInvocation()
Rimuovi un'invocazione in sospeso dopo che il tuo handler l'ha elaborata.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.removePendingInvocation({ id: 'id-123' });
setEntityCatalog()
Persisti un catalogo di entità per una determinata stringa di tipo.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.setEntityCatalog({
type: 'type',
entries: [
{
id: 'id-123',
title: 'Hello from Capacitor',
},
],
});
setHomeScreenShortcutItems()
Sostituisci le quick actions della Home Screen (UIApplicationShortcutItems).
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.setHomeScreenShortcutItems({
items: [
{
type: 'type',
title: 'Hello from Capacitor',
},
],
});
indexSpotlightEntities()
Indicizza gli elementi Spotlight per il dominio della tua app.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.indexSpotlightEntities({
entities: [
{
id: 'id-123',
title: 'Hello from Capacitor',
actionName: 'action',
},
],
});
removeSpotlightEntities()
Rimuovi gli elementi Spotlight tramite ID.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.removeSpotlightEntities({ ids: ['ids'] });
La tabella sopra elenca i 7 metodi core. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapgoAppIntents.removeAllListeners() per rimuovere tutti i listener.