Konfigurieren Sie iOS Sandbox-Test

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

Banking- und Steuerabrechnungsbegünstigung kann Stunden bis Tage dauern. Führen Sie dies gut im Voraus der Testung aus.

Setup-Prozess

1. Zahlungspflichtige Anwendungsvereinbarung unterzeichnen

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

   • Zahlungspflichtige Anwendungsvereinbarung unterzeichnen
   • Hinzufügen Ihrer Bankverbindung
   • Steuerscheine 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. Bewegen Sie sich bis zum unteren Ende
   4. Tippen Sandbox-Konto
   5. Mit Ihrem Sandbox-Testkonto anmelden

   Tipp

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

4. Konfigurieren Sie das Xcode-Projekt

   Stellen Sie sicher, dass Ihr Xcode-Projekt folgendes enthält:

   Bundle-Identifier

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

   In-App-Kauffunktion

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

5. In-App-Kaufprodukte erstellen

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

   Produkte müssen mindestens im Status „Zur Übermittlung bereit“ sein, um Sandbox-Tests durchzuführen.

6. Testen Sie Ihre Implementierung

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

   [Umgebung: Sandbox]

   Diese Bestätigung zeigt an, dass Sie sich im Sandbox-Umgebung befinden und keine echten Gelder berechnet werden.

Wichtige Hinweise

Eigenschaften der Sandbox-Umgebung

• Keine echten Gebühren: Alle Käufe sind in Sandbox-Modus kostenlos
• Geschützte Abonnements: Die Abonnementdauern werden verkürzt, um das Testen zu beschleunigen
  • 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
• Unmittelbare KündigungAbgelaufene Abonnements werden sofort gekündigt

Sandbox-Konto-Verwaltung

• Erstellen Sie mehrere Testkonten für verschiedene Szenarien
• Verwenden Sie Testkonten nur auf Testgeräten
• Verwenden Sie keinen persönlichen Apple-ID für Sandbox-Tests
• Testkonten können Produkte in jedem Land kaufen

Sandbox-Testen

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 die Einstellungen ordnungsgemäß 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 korrekt validiert
5. Abonnements erneuern automatisch (bei beschleunigter Geschwindigkeit)

Fehlersuche

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 auf Fehlermeldungen
• Überprüfen Sie, ob die In-App-Kauffähigkeit aktiviert ist
• Stellen Sie sicher, dass die E-Mail-Adresse des Sandbox-Kontos keine echte Apple-ID ist
• Versuchen Sie, ein neues Sandbox-Testkonto zu erstellen

Fehler bei der Rechnungsvalidierung:

• Verwenden Sie in der Testphase den Sandbox-Endpunkt für die Rechnungsvalidierung
• Produktionsendpunkt: 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 oben stehende Umrechnungstabelle für die erwartete Dauer
• Abonnements automatisch bis zu 6 Mal wiederholen in Sandbox

„Diese 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 verwendet

Best Practices

1. Mehrere Testkonten erstellen für verschiedene Testfälle
2. Alle Abonnementdauern testen um das Verhalten zu überprüfen
3. Kündigung und Wiederholung testen Flüsse
4. Empfängerbestätigung überprüfen funktioniert richtig
5. Kaufwiederherstellungstest Funktionalität
6. Abonnementauf- und -abbau überprüfen Verhalten
7. Test unter schlechten Netzwerkbedingungen

Produktion vs. Sandbox

Funktion	Sandbox	Produktion
Echte Gebühren	Nein	Ja
Laufzeit der Abonnement	Beschleunigt	Normal
Limitierung der automatischen Erneuerung	6 Mal	Unbegrenzt
Auswirkung der Kündigung	Sofortig	Ende der Periode
Beleg-Endpunkt	Sandbox-URL	Produktions-URL
Nur Testkonten	Ja	Nein

Zusätzliche Ressourcen

Weitere Informationen finden Sie im offiziellen Apple StoreKit-Dokumentation zu Sandbox-Testen.

Fortschrittlich von Konfigurieren Sie den iOS Sandbox-Test

Wenn Sie Konfigurieren Sie den iOS Sandbox-Test um die Genehmigung und Verteilung im App Store zu planen, verbinden Sie es mit Mit @capgo/native-purchases für die native Fähigkeit in Mit @capgo/native-purchases, @capgo/capacitor-in-app-Bewertung für die Implementierungsdetail in @capgo/capacitor-in-app-Bewertung, Mit @capgo/capacitor-in-app-Bewertung für die native Fähigkeit in Mit @capgo/capacitor-in-app-Bewertung, @capgo/capacitor-native-Markt für die Implementierungsdetails in @capgo/capacitor-native-market, und Mit @capgo/capacitor-native-market für die native Fähigkeit in Mit @capgo/capacitor-native-market.