Salta al contenuto principale
@capgo/capacitor-app-intents UI e sistema Open source

Intent dell'app Plugin Capacitor

Distribuisci frasi Siri, Shortcuts, Spotlight, azioni rapide della schermata Home e cataloghi di entità App Intents da Capacitor senza ricostruire il web layer per ogni azione

Installa

bun add @capgo/capacitor-app-intents bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-app-intents
  • pnpm add @capgo/capacitor-app-intents
  • yarn add @capgo/capacitor-app-intents

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.

Riferimento completo

FAQ

FAQ del plugin App Intents

Come installo il plugin App Intents in un'app Capacitor?

Esegui "bun add @capgo/capacitor-app-intents" (oppure "npm install @capgo/capacitor-app-intents"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-app-intents" nel tuo code dell'app.

Funziona @capgo/capacitor-app-intents con React, Vue e Angular?

Sì. App Intents è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, incluso Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-app-intents?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-app-intents è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-app-intents/ e il pacchetto è gratuito da installare da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa App Intents senza una revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche a App Intents senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo