Solana-Mobile-Apps veröffentlichen: Eine Anleitung

Materialien

Folge der Anleitung und stelle die für die Veröffentlichung erforderlichen Materialien zusammen. Das Ziel ist ein veröffentlichungsfertiges Android Package Kit (APK). Die folgende Checkliste enthält alle Materialien, die du für die Veröffentlichung sammeln und vorbereiten musst.

Checkliste

• Veröffentlichungsfertiger Build
• Android Build Tools
• Versionsinformationen
• Tools zur Fehlerberichterstattung wie Sentry
• Assets für die dApp und den dApp Store
• Helius RPC-URL
• App-Signaturschlüssel 
• Herausgeberschlüssel
• Bedingungen und Vereinbarungen 
• Lizenz
• Datenschutzrichtlinie
• Urheberrecht

Für die Veröffentlichung in App-Stores gelten Bedingungen für Herausgeber und Verbraucher. Sie schützen Nutzer und begrenzen die Haftung der Herausgeber. Herausgeber im Solana dApp Store stimmen vor der Veröffentlichung der Herausgeberrichtlinie, der Vereinbarung zur Veröffentlichung von dApps und den Nutzungsbedingungen des dApp Store zu.

Der Herausgeber muss während des Veröffentlichungsprozesses einen Endbenutzer-Lizenzvertrag (EULA), eine Datenschutzrichtlinie und einen Urheberrechtshinweis bereitstellen. Beschaffe diese Dokumente als Entwickler und stelle sie online zur Verfügung – während der Veröffentlichung brauchst du Links zu ihnen. Nutze Ressourcen wie Generatoren für Datenschutzrichtlinien, einen Muster-Urheberrechtshinweis oder ChatGPT, um die Dokumente zu erstellen.

Vorbereitung

Die Vorbereitung einer dApp für den Start beginnt mit einem für die Veröffentlichung konfigurierten Build. 

Bereinige zuerst das Repository. Entferne Konsolenprotokolle und überwache die dApp mit Tools zur Fehlerberichterstattung. Prüfe außerdem die Umgebungsvariablen und aktualisiere sie für die Produktionsumgebung.

Stelle anschließend sicher, dass alle Assets die richtige Größe haben, und entferne unnötige Dateien. Vorschaubilder für den dApp Store müssen eine Auflösung von 1080p (1920px × 1080px) haben und durchgehend horizontal oder vertikal ausgerichtet sein. Icons für den dApp Store dürfen höchstens 512x512px groß sein und müssen quadratisch sein.

Für die Veröffentlichung im dApp Store ist ein Solana-Schlüsselpaar erforderlich. Erstelle mit solana-keygen ein neues Schlüsselpaar und statte es für später mit Solana aus. Bewahre dieses Schlüsselpaar sicher auf. Andernfalls kann jeder, der darauf zugreifen kann, spätere Versionen der dApp im dApp Store einreichen.

Wenn Apps für die Veröffentlichung gebaut werden, muss ein App-Schlüssel den Build signieren. Neue Apps benötigen neue Signaturschlüssel. Verwende nicht denselben Schlüssel wie für den Debug-Build. Genau wie beim Herausgeberschlüssel kann jeder mit dem App-Schlüssel die App aktualisieren. Öffne ein Terminal und füge den folgenden Befehl ein, um den App-Signaturschlüssel mit keystore zu erstellen.

keytool -genkey -v -keystore release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 10000

Erstelle release-key.keystore und storePassword (dient auch als keyPassword) im aktuellen Verzeichnis. Verwende das folgende Codebeispiel, um die Veröffentlichungswerte signingConfigs und buildTypes in build.gradle zu erstellen.

signingConfigs {
        release {
            storeFile file('release.keystore')
            storePassword 'password'
            keyAlias 'release-key'
            keyPassword 'password'
        }
    }
    buildTypes {
        debug {
            signingConfig signingConfigs.debug
        }
        release {
            signingConfig signingConfigs.release
            minifyEnabled enableProguardInReleaseBuilds
            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
            debuggable false
        }
    }

Lege in derselben Datei den locale(s) der App fest und aktualisiere versionCode und versionName. Dies ist die letzte Gelegenheit, applicationId zu ändern.

Nachdem du die Signatur für die Veröffentlichung konfiguriert hast, kannst du die dApp für die Produktion bauen. Führe im dApp-Verzeichnis den folgenden Befehl aus, um doppelte Ressourcen aus dem Debug-Build zu bereinigen und den Veröffentlichungs-Build zu erstellen.

Bei Erfolg erzeugt der Befehl ein APK im Ordner /android/app/build/outputs/apk.

yarn react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/build/intermediates/res/merged/release/ && rm -rf android/app/src/main/res/drawable-* && rm -rf android/app/src/main/res/raw/* && cd android && ./gradlew assembleRelease && cd ..

Schritte zur Veröffentlichung

Für die Veröffentlichung im dApp Store musst du die CLI-Tools des Stores verwenden. Dieser Abschnitt fasst die Einrichtungsschritte von Solana Mobile für die Veröffentlichung im dApp Store zusammen:

1. Installiere die CLI-Tools des dApp Store.
2. Erstelle und validiere config.yaml.
3. Präge die App-, Publisher- und Release-NFTs.
4. Reiche die App ein und veröffentliche sie.

Führe im Veröffentlichungsverzeichnis die folgenden Befehle aus:

pnpm init
pnpm install --save-dev @solana-mobile/dApp-store-cli
npx dApp-store init

Der Initialisierungsbefehl erstellt eine Datei namens config.yaml. Mit ihr konfigurierst du, wie die dApp im dApp Store angezeigt wird. Du musst drei Abschnitte ausfüllen: publisher, app und release.

Alle diese Abschnitte enthalten ein Adressfeld, das bei der ersten Veröffentlichung leer bleiben muss. Die Veröffentlichungsschritte erstellen NFTs für jeden Abschnitt und aktualisieren die Adressen automatisch.

Dies ist eine leere Vorlage für config.yaml. Eine vorausgefüllte Version findest du im GitHub-Repository dapp-publishing.

publisher:
  name:
  address:
  website:
  email:
  media:
    - purpose: icon
      uri:
app:
  name:
  address:
  android_package:
  urls:
    license_url:
    privacy_policy_url:
    copyright_url:
    website:
  media:
    - purpose: icon
      uri:
release:
  address:
  media:
    - purpose: icon
      uri:
    - purpose: screenshot
      uri:
    - purpose: screenshot
      uri:
    - purpose: screenshot
      uri:
  files:
    - purpose: install
      uri:
  catalog:
    en-US:
      name:
      short_description:
      long_description:
      new_in_version:
      saga_features:
solana_mobile_dApp_publisher_portal:
  google_store_package:
  testing_instructions:

Für neue App-Updates kannst du den Release-Abschnitt ändern. Fülle die Medienfelder aus, um Vorschaubilder und Icons im dApp Store anzuzeigen. Für die Installation der Datei musst du den Pfad zum APK angeben. Lege diese Dateien im Veröffentlichungs-Repository ab und gib die relativen Pfade als URI an. Du kannst die App-Beschreibungen im Katalog bearbeiten. Felder wie google_store_package und saga_features sind optional.

Sobald du config.yaml ausgefüllt hast, prüfe die Gültigkeit der Veröffentlichung mit dem folgenden Befehl sowie den Pfaden zum Solana-Schlüsselpaar und zu den Android Build Tools.

Wenn die Android Build Tools über Android Studio installiert wurden, findest du den Pfad, indem du Android Studio öffnest, auf das Dropdown-Menü Tools klickst und SDK Manager auswählst.

Navigiere zum Tab SDK Tools und klicke auf Android_SDK_Build_Tools 34, um den Pfad zu den Build-Tools anzuzeigen. Der Pfad sollte so aussehen: C:\Users\user\AppData\Local\Android\Sdk.

npx dApp-store validate -k path_to_keypair -b path_to_android_sdk_build_tools

Für die Veröffentlichung im dApp Store werden NFTs für jeden Abschnitt von config.yaml erstellt.

Erstelle zunächst das Publisher-NFT. Dies ist ein einmaliger Vorgang. Bei späteren Veröffentlichungen ist dieser Schritt daher nicht erforderlich. Ersetze mainnet_beta_rpc_url durch eine Helius RPC-URL.

npx dApp-store create publisher -k path_to_your_keypair -u mainnet_beta_rpc_url

Auch das App-NFT musst du nur einmal erstellen. Dieser Befehl erstellt das App-NFT und speichert die Mint-Adresse in config.yaml.

npx dApp-store create app -k path_to_keypair -u mainnet_beta_rpc_url

Erstelle das Release-NFT mit dem folgenden Befehl. Für jede neue Version, die du im dApp Store einreichst, musst du ein neues Release-NFT erstellen. Die Mint-Adresse wird bei jeder Ausführung des Befehls automatisch aktualisiert.

npx dApp-store create release -k path_to_keypair -b path_to_android_sdk_build_tools -u mainnet_beta_rpc_url

Sobald alle drei NFTs erfolgreich erstellt wurden, kannst du die App beim dApp Store einreichen.

Veröffentliche die App mit dem folgenden Befehl und übergib die Flags --requestor-is-authorized --complies-with-solana-dApp-store-policies, um die Einhaltung der Vorgaben zu bestätigen.

npx dApp-store publish submit -k path_to_keypair -u mainnet_beta_rpc_url --requestor-is-authorized --complies-with-solana-dApp-store-policies

Nachdem du die dApp beim dApp Store eingereicht hast, kontaktiert dich das Team von Solana Mobile über die E-Mail-Adresse aus dem Publisher-Abschnitt. Alternativ kannst du das Team von Solana Mobile im Kanal #dapp store kontaktieren. Die übliche Prüfung dauert bei neuen Apps zwei bis drei Tage und bei Updates einen Tag.

Gedanken nach dem Start

Die erste Veröffentlichung im dApp Store kann einschüchternd wirken. Mit den richtigen Tools lässt sich der Prozess jedoch vereinfachen. Beim Start der Chonky-dApp konnten Saga-Nutzer den Airdrop beim ersten Versuch beanspruchen. Es gab lediglich kleinere mobile Probleme: Wallet-Modals funktionierten im Energiesparmodus nicht und ungeduldige Nutzer brachen die Signaturanfrage ab. Sobald die dApp veröffentlicht ist, zeigt sich der Wert der Fehlerprotokollierung. Sie überwacht Fehler in Echtzeit und zeichnet das Nutzerverhalten auf. Nutze Protokollierungstools, um wichtige Nutzungsdaten zu erhalten. Solana Mobile erfasst derzeit keine Daten wie Aufrufe und App-Downloads. Deshalb müssen Entwickler eine geeignete Protokollierung in ihrer App implementieren. 

Mobile Entwicklung bedeutet, den Nutzer an erste Stelle zu setzen. Vom UX-Design bis zu Signaturabläufen optimieren mobile Entwickler das Durchsuchen digitaler Oberflächen für ein nahtloses, integriertes Erlebnis. In einer Welt mit knapper Aufmerksamkeit wollen Apps einen Platz auf dem Startbildschirm der Nutzer erobern. Aufgrund restriktiver Veröffentlichungsrichtlinien beliebter App-Stores schaffen es nur wenige Apps, lohnende Krypto-Anwendungen auf Mobilgeräte zu bringen. Die Blockchain-Technologie von Solana ermöglicht es, Nutzer in großem Umfang zu belohnen. Solana Mobile ist bestens positioniert, um die Interaktion mit kryptonativen Anwendungen voranzutreiben. Da Saga Chapter 2 für 2025 bevorsteht, ist jetzt der perfekte Zeitpunkt, dApps für den Solana dApp Store zu entwickeln.

Wenn dich diese Anleitung zu einer einzigartigen dApp inspiriert hat, abonniere den Helius-Blog und lies unsere Artikel zur Weiterbildung für Solana-Entwickler. Du besitzt ein Saga und möchtest mit dem Solana Mobile Stack entwickeln? Das Tutorial Token-Gating auf Solana Mobile ist ideal für Android-Einsteiger, die mit Typescript vertraut sind. Tritt der Helius Hacker Society auf Discord bei und erhalte weitere Inhalte zur mobilen Entwicklung auf Solana. Bei Fragen hilft dir Helius im Helius Forum.

Weitere Ressourcen

• Entwicklungsumgebung für Android-Mobilgeräte einrichten 
• Referenz zum Mobile Wallet Adapter
• Solana SDK für React Native
• Architektur mobiler dApps
• App für die Veröffentlichung vorbereiten
• Android Studio
• GitHub-Repository zur Veröffentlichung von Solana-Mobile-dApps 
• Dokumentation zur Veröffentlichung von Solana-Mobile-dApps
• Spezifikationen für die Veröffentlichung im dApp Store
• Solana Mobile Discord