Konfigurieren Sie iOS Sandbox-Testen

Die Durchführung von In-App-Käufen auf iOS erfordert eine ordnungsgemäße Konfiguration in App Store Connect und auf Ihren Testgeräten. Diese Anleitung deckt alles ab, was Sie zum Starten mit dem Sandbox-Testen benötigen.

Voraussetzungen

• Apple-Entwicklerprogramm: Aktive Mitgliedschaft mit jährlicher Erneuerung
• Zustimmungen: Unterzeichnetes “Zahlungspflichtiges Anwendungsabkommen” mit Bank- und Steuerinformationen abgeschlossen
• Xcode-Projekt: Konfiguriert mit korrektem Bundle-Identifier und -Fähigkeiten

Hinweis

Die Genehmigung der Bank- und Steuererfassung kann Stunden bis Tage dauern. Führen Sie dies daher im Voraus zu den Tests aus.

Setup-Prozess

1. Zustimmung zum Bezahlten Anwendungsabkommen

   In App Store Connect navigieren Sie zu Zustimmungen, Steuern und Bankverbindungen und füllen Sie aus:

   • Das Bezahlte Anwendungsabkommen unterzeichnen
   • Ihre Bankverbindung hinzufügen
   • Die Steuerformulare ausfüllen

   Warten Sie auf die Genehmigung durch Apple (dies kann 24-48 Stunden dauern).

2. Sandbox-Testnutzer erstellen

   In App Store Connect, gehen Sie zu Benutzer und Zugriff > Sandbox-Testern.

   Klicken Sie auf den + Button, um einen neuen Sandbox-Tester zu erstellen.

   Wichtig:Verwenden Sie eine E-Mail-Adresse, die NICHT bereits mit einem Apple-Konto verbunden ist. Sie können E-Mail-Aliase verwenden:

   • Gmail: youremail+test@gmail.com
   • iCloud: youremail+test@icloud.com

   

3. Testgerät konfigurieren (iOS 12+)

   Ab iOS 12 benötigen Sie nicht mehr, um sich aus Ihrem iTunes-Konto auszuloggen, um Kauftests durchzuführen.

   Auf Ihrem iOS-Gerät:

   1. Öffnen Einstellungen
   2. Tippen App Store
   3. Bis zum Ende scrollen
   4. Tippen Sandbox-Konto
   5. Mit Ihrem Sandbox-Testkonto anmelden

   Tipp

   Das ist viel bequemer als das alte Verfahren, sich von Ihrem iTunes-Konto abzumelden!

4. Configure Xcode Projekt

   Stellen Sie sicher, dass Ihr Xcode-Projekt folgende Anforderungen erfüllt:

   Bundle-Identifier

   • Muss der Identifikator im Developer Center entsprechen
   • Muss der Identifikator in App Store Connect entsprechen

   In-App-Kauffähigkeit

   1. Wählen Sie Ihr Projekt in Xcode
   2. Gehe zu Zertifizierung und Fähigkeiten
   3. Klicken Sie auf + Fähigkeit
   4. Hinzufügen In-App-Kauf

5. Erstellen Sie In-App-Kaufprodukte

   In App Store Connect navigieren Sie zu Ihrer App und erstellen Sie Ihre In-App-Kaufprodukte (Abonnements, Verbrauchsgüter usw.).

   Produkte müssen mindestens im Status „Bereit zum Einreichen“ sein, um Sandbox-Tests durchzuführen.

6. Ihr Implementierung testen

   Erstellen und ausführen Sie Ihre App auf einem Testgerät. Wenn Sie einen Kaufversuch durchführen, sollten Sie sehen:

   [Umgebung: Sandbox]

   Diese Bestätigung zeigt an, dass Sie sich in der Sandbox-Umgebung befinden und werden nicht mit echtem Geld belastet.

Wichtige Hinweise

Eigenschaften der Sandbox-Umgebung

• Keine echten Gebühren: Alle Kaufs sind in Sandbox-Modus kostenlos
• Geschwindigkeitsabonnements: Die Abonnementdauern werden verkürzt, um schnellere Tests zu ermöglichen
  • 1-Wochen-Abonnement = 3 Minuten
  • 1-Monats-Abonnement = 5 Minuten
  • 2-Monats-Abonnement = 10 Minuten
  • 3-Monats-Abonnement = 15 Minuten
  • 6-Monats-Abonnement = 30 Minuten
  • 1-Jahres-Abonnement = 1 Stunde
• Limitierte Wiederholung: Die Abonnements wiederholen sich bis zu 6 Mal in Sandbox
• Eilabbruch: Abgelaufene Abonnements werden sofort storniert

Sandbox-Konto-Verwaltung

• Erstellen Sie mehrere Testkonten für verschiedene Szenarien
• Verwenden Sie Testkonten nur auf Testgeräten
• Verwenden Sie keine persönliche Apple-ID für Sandbox-Tests
• Testkonten können Produkte jeder Region kaufen

Sandbox-Testen verwenden

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}

// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Test purchase successful!', transaction.transactionId);

Verifizierung

Wenn Sie richtig konfiguriert haben, sollten Sie Folgendes beobachten:

1. Sandbox-Banner während des Kaufs: „[Umgebung: Sandbox]“
2. Produkte laden erfolgreich
3. Käufe abschließen ohne tatsächliche Gebühren
4. Rechnungen werden richtig
5. Abonnements erneuern automatisch (bei beschleunigter Geschwindigkeit)

Fehlerbehebung

Produkte laden nicht:

• Überprüfen Sie, ob die Bundle-Identifikationsnummer mit App Store Connect übereinstimmt
• Stellen Sie sicher, dass Vereinbarungen unterzeichnet und genehmigt sind
• Stellen Sie sicher, dass Produkte mindestens im Status „Zur Veröffentlichung bereit“ sind
• Warten Sie 2-3 Stunden nach der Erstellung von Produkten

“Kann nicht mit iTunes Store verbunden werden”:

• Überprüfen Sie, ob der Sandbox-Konto korrekt konfiguriert ist
• Überprüfen Sie, ob das Gerät an das Internet angeschlossen ist
• Versuchen Sie, sich aus dem Sandbox-Konto auszuloggen und wieder einzuloggen
• Neustarten Sie die App

Käufe schweigen still:

• Überprüfen Sie das Xcode-Konsolenfenster für Fehlermeldungen
• Stellen Sie sicher, dass die In-App-Kauffähigkeit aktiviert ist
• Stellen Sie sicher, dass die Sandbox-E-Mail-Adresse keine echte Apple-ID ist
• Versuchen Sie, ein neues Sandbox-Testkonto zu erstellen

Fehler bei der Belegvalidierung:

• Verwenden Sie in der Testphase den Sandbox-Belegvalidierungs-Endpunkt
• Produktions-Endpunkt: https://buy.itunes.apple.com/verifyReceipt
• Sandbox-Endpunkt: https://sandbox.itunes.apple.com/verifyReceipt
• Der native-purchases-Plugin handhabt dies automatisch

Falsche Abonnementdauer:

• Denken Sie daran, dass Abonnements im Sandbox beschleunigt sind
• Verwenden Sie die Umrechnungstabelle oben für die erwarteten Dauer
• Abonnements automatisch wiederholen max. 6 Mal im Sandbox-Modus

„Dieser Apple-ID wurde noch nicht im iTunes Store verwendet“:

• Das ist normal für neue Sandbox-Konten
• Mit der Bestellung aktivieren Sie das Konto
• Erstes Mal nur auftritt

Gute Praktiken

1. Erstellen Sie mehrere Testkonten für verschiedene Test-Szenarien
2. Testen Sie alle Abonnementdauern um das Verhalten zu überprüfen
3. Test-Stornierung und -erneuerung Flussfolgen
4. Empfangsbestätigung überprüfen funktioniert richtig
5. Test der Wiederherstellung von Kaufleistungen Funktionalität
6. Überprüfung der Abonnement-Auf- und -Herabstufung Verhalten
7. Test unter schlechten Netzwerkbedingungen

Produktions- vs. Sandbox-Modus

Funktion	Sandbox	Produktionsumgebung
Echte Gebühren	Nein	Ja
Abonnementdauer	Geschwindig	Normal
Automatischer Erneuerungslimit	6 Mal	Unbegrenzt
Kündigungsfolge	Echtzeit	Ende der Periode
Bezahlschnittstelle	Sandbox-URL	Produktions-URL
Nur Testkonten	Ja	Nein

Zusätzliche Ressourcen

Zur genauen Beschreibung siehe die offizielle Apple StoreKit-Dokumentation auf Sandbox-Testen.

Weitermachen von Konfigurieren Sie iOS-Sandbox-Testen

Wenn Sie Konfigurieren Sie iOS-Sandbox-Testen zur Planung der Genehmigung im App Store und der Verteilung, verbinden Sie es mit Mit @capgo/native-purchases für die native Fähigkeit in Mit @capgo/native-purchases, @capgo/capacitor-in-app-review für die Implementierungsdetails in @capgo/capacitor-in-app-review, Mit @capgo/capacitor-in-app-review für die native Fähigkeit in Mit @capgo/capacitor-in-app-review, @capgo/capacitor-native-Markt für die Implementierungsdetails in @capgo/capacitor-native-Markt, und Mit @capgo/capacitor-native-Markt für die native Fähigkeit in Mit @capgo/capacitor-native-Markt.