Zum Hauptinhalt springen
@capgo/capacitor-sim Device-APIs Open Source

SIM Capacitor Plugin

SIM-Karteninformationen einschließlich Name des Netzbetreibers, Land code und Telefonnummer abrufen

Installieren

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

Anleitung

SIM in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR-code zur SIM-Plugin-Vorschau

Verwendung von @capgo/capacitor-sim

Capacitor SIM-Plugin zum Abrufen von Informationen von SIM-Karten des Geräts.

Installieren

bun add @capgo/capacitor-sim
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
getSimCards Informationen von den SIM-Karten des Geräts abrufen.
checkPermissions Berechtigung für den Zugriff auf SIM-Karteninformationen prüfen.
requestPermissions Berechtigung für den Zugriff auf SIM-Karteninformationen anfordern.

Beispiele

getSimCards()

Informationen von den SIM-Karten des Geräts abrufen.

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

Berechtigung für den Zugriff auf SIM-Karteninformationen prüfen.

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

Berechtigung für den Zugriff auf SIM-Karteninformationen anfordern.

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

Vollständige Referenz

Weiterlesen unter Verwendung von @capgo/capacitor-sim

Wenn du es nutzt Verwendung von @capgo/capacitor-sim um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-sim für die Implementierungsdetails in @capgo/capacitor-sim, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

SIM Plugin FAQ

Wie installiere ich das SIM-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-sim" (oder "npm install @capgo/capacitor-sim") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-sim".

Funktioniert @capgo/capacitor-sim mit React, Vue und Angular?

Ja. SIM ist ein Capacitor-Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-sim?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-sim kostenlos und Open Source?

Ja. Der code-Code ist auf GitHub unter https://github.com/Cap-go/capacitor-sim/ öffentlich einsehbar und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das SIM nutzt, ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

SIM-Änderungen ausrollen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo