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

SIM Plugin Capacitor

Recupera le informazioni della SIM, tra cui nome dell'operatore, paese code e numero di telefono

Installa

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

Guida

Come usare SIM in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima QR del plugin SIM code

Utilizzo di @capgo/capacitor-sim

Plugin SIM di Capacitor per recuperare informazioni dalle schede SIM del dispositivo.

Installa

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

API in breve

Metodo Descrizione
getSimCards Ottieni informazioni dalle schede SIM del dispositivo.
checkPermissions Controlla il permesso per accedere alle informazioni della SIM.
requestPermissions Richiedi il permesso per accedere alle informazioni della SIM.

Esempi

getSimCards()

Ottieni informazioni dalle schede SIM del dispositivo.

import { Sim } from '@capgo/capacitor-sim';

const { simCards } = await Sim.getSimCards();
simCards.forEach((sim, index) => {
  console.log(`SIM ${index + 1}:`);
  console.log(`  Carrier: ${sim.carrierName}`);
  console.log(`  Country: ${sim.isoCountryCode}`);
  console.log(`  MCC: ${sim.mobileCountryCode}`);
  console.log(`  MNC: ${sim.mobileNetworkCode}`);
});

checkPermissions()

Controlla il permesso per accedere alle informazioni della SIM.

import { Sim } from '@capgo/capacitor-sim';

const status = await Sim.checkPermissions();
if (status.readSimCard === 'granted') {
  console.log('Permission granted');
} else {
  console.log('Permission not granted');
}

requestPermissions()

Richiedi il permesso per accedere alle informazioni della SIM.

import { Sim } from '@capgo/capacitor-sim';

const status = await Sim.requestPermissions();
if (status.readSimCard === 'granted') {
  // Now you can call getSimCards()
  const simCards = await Sim.getSimCards();
}

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-sim

Se stai usando Utilizzo di @capgo/capacitor-sim per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-sim per i dettagli di implementazione in @capgo/capacitor-sim, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.

FAQ

FAQ sul plugin SIM

Come installo il plugin SIM in un'app Capacitor?

Esegui "bun add @capgo/capacitor-sim" (o "npm install @capgo/capacitor-sim"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-sim" nel code della tua app.

@capgo/capacitor-sim funziona con React, Vue e Angular?

Sì. SIM è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-sim?

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

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-sim/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa SIM senza passare dalla review 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.

Distribuisci modifiche SIM senza attendere 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