Aller au contenu principal
@capgo/capacitor-sim API de l'appareil Open source

SIM Plugin Capacitor

Récupérer les informations de la carte SIM, notamment le nom de l'opérateur, le pays code et le numéro de téléphone

Installer

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

Guide

Comment utiliser SIM dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

QR d'aperçu du plugin SIM code

Utiliser @capgo/capacitor-sim

Capacitor Plugin SIM pour récupérer les informations des cartes SIM de l'appareil.

Installer

bun add @capgo/capacitor-sim
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
getSimCards Récupérez les informations des cartes SIM de l'appareil.
checkPermissions Vérifiez la permission d'accéder aux informations de la carte SIM.
requestPermissions Demandez la permission d'accéder aux informations de la carte SIM.

Exemples

getSimCards()

Récupérez les informations des cartes SIM de l'appareil.

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

Vérifiez la permission d'accéder aux informations de la carte 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()

Demandez la permission d'accéder aux informations de la carte 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();
}

Référence complète

Continuer depuis « Utiliser @capgo/capacitor-sim »

Si vous utilisez Utiliser @capgo/capacitor-sim pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-sim pour les détails d'implémentation dans @capgo/capacitor-sim, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.

FAQ

FAQ du plugin SIM

Comment installer le plugin SIM dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-sim" (ou "npm install @capgo/capacitor-sim"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-sim" dans le code de votre application.

Est-ce que @capgo/capacitor-sim fonctionne avec React, Vue et Angular ?

Oui. SIM est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-sim ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-sim est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-sim/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant SIM sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements SIM sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo