Salta al contenuto principale
@capgo/capacitor-health API dei dispositivi Open source

Stato Plugin Capacitor

Accedi ai dati su salute e fitness dalle piattaforme native

Installa

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

Guida

Come usare Health in Capacitor

Utilizzo di @capgo/capacitor-health

Il plugin Capacitor per interagire con i dati da Apple HealthKit e Health Connect.

Installa

bun add @capgo/capacitor-health
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 { Health } from '@capgo/capacitor-health';

API in breve

Metodo Descrizione
isAvailable Restituisce se la piattaforma corrente supporta il health nativo SDK.
requestAuthorization Richiede l'accesso in lettura/scrittura ai tipi di dati specificati.
checkAuthorization Verifica lo stato di autorizzazione per i tipi di dati specificati senza sollecitare l'utente.
readSamples Legge i campioni per il tipo di dati specificato nell'intervallo di tempo indicato.
saveSample Scrive un singolo campione nel health store nativo.
openHealthConnectSettings Apre la schermata delle impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla.
showPrivacyPolicy Mostra l'informativa sulla privacy dell'app per Health Connect (solo Android). Su iOS, questo metodo non fa nulla.
queryWorkouts Interroga le sessioni di allenamento dal health store nativo. Supportato su iOS (HealthKit) e Android (Health Connect).
queryAggregated Interroga i dati sanitari aggregati dal health store nativo. Aggrega i dati in bucket temporali (ora, giorno, settimana, mese) con operazioni come somma, media, min o max. È più efficiente rispetto al recupero di singoli campioni per ampi intervalli di date.

Esempi

isAvailable()

Restituisce se la piattaforma corrente supporta il SDK sanitario nativo.

import { Health } from '@capgo/capacitor-health';

const result = await Health.isAvailable();
console.log(result);

requestAuthorization()

Richiede l'accesso in lettura/scrittura ai tipi di dati forniti.

import { Health } from '@capgo/capacitor-health';

const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);

checkAuthorization()

Verifica lo stato di autorizzazione per i tipi di dati forniti senza sollecitare l'utente.

import { Health } from '@capgo/capacitor-health';

const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);

readSamples()

Legge i campioni per il tipo di dati specificato all'interno dell'intervallo di tempo indicato.

import { Health } from '@capgo/capacitor-health';

const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);

saveSample()

Scrive un singolo campione nel health store nativo.

import { Health } from '@capgo/capacitor-health';

await Health.saveSample({
  dataType: 'steps',
  value: 1,
});

openHealthConnectSettings()

Apre la schermata di impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla.

import { Health } from '@capgo/capacitor-health';

await Health.openHealthConnectSettings();

La tabella sopra elenca i 9 metodi core. Gli helper per listener e versioni e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-health

Se stai usando Utilizzo di @capgo/capacitor-health per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-health per i dettagli implementativi in @capgo/capacitor-health, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ del plugin Health

Come installo il plugin Health in un'app Capacitor?

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

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

Sì. Health è 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-health?

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-health è gratuito e open source?

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

Posso aggiornare code che usa Health senza passare per la 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.

Rilascia le modifiche a Health 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