Testen auf lokalen Geräten

Wenn Sie unsere Vorlagen verwenden, startet Needle Engine für Sie einen lokalen Entwicklungsserver. Drücken Sie einfach auf Play, und eine Website öffnet sich in Ihrem Standardbrowser, bereit zum Testen auf Ihrem lokalen Gerät. Für das Testen auf anderen Geräten im selben Netzwerk müssen Sie möglicherweise ein selbstsigniertes Zertifikat installieren (siehe unten).

Wenn Sie ein benutzerdefiniertes Setup / Framework verwenden, lesen Sie bitte die Dokumentation Ihres Frameworks, wie Sie einen sicheren lokalen Entwicklungsserver starten.

Einrichten eines selbstsignierten Zertifikats für die Entwicklung

Verschiedene Betriebssysteme haben unterschiedliche Sicherheitsanforderungen für die lokale Entwicklung. Typischerweise funktioniert die Anzeige einer Website auch mit einem automatisch generierten, nicht vertrauenswürdigen Zertifikat, aber Browser können vor dem fehlenden Vertrauen warnen und einige Funktionen sind nicht verfügbar. Hier ist eine Zusammenfassung:

Standard – mit automatisch generiertem, nicht vertrauenswürdigem ZertifikatZeigt beim Öffnen des Projekts in einem Browser eine Zertifikatswarnung an.Verwendet das vite-plugin-basic-ssl npm-Paket.

Wir verwenden websocket-Verbindungen zur Kommunikation zwischen dem Browser und dem lokalen Entwicklungsserver. Websockets erfordern eine sichere Verbindung (HTTPS), um zu funktionieren. Abhängig von der Plattform müssen Sie möglicherweise ein benutzerdefiniertes Zertifikat für die lokale Entwicklung einrichten. Android und Windows benötigen kein benutzerdefiniertes Zertifikat, aber iOS und MacOS schon.

Mit einem selbstsignierten, vertrauenswürdigen Root-ZertifikatEs wird keine Sicherheitswarnung angezeigt. Sie müssen das generierte Zertifikat auf Ihren Geräten installieren.Verwendet das vite-plugin-mkcert npm-Paket.

Generieren eines selbstsignierten Entwicklungszertifikats

• Klicken Sie in Unity/Blender auf "Open Workspace", um VS Code zu öffnen.

• Überprüfen Sie, ob Sie vite-plugin-mkcert anstelle von vite-plugin-basic-ssl verwenden (letzteres generiert kein vertrauenswürdiges Root-Zertifikat, das wir benötigen) in Ihrer vite.config.ts Datei:

  • Öffnen Sie package.json.
  • Entfernen Sie die Zeile mit "@vitejs/plugin-basic-ssl" aus devDependencies.
  • Öffnen Sie ein Terminal in VS Code und führen Sie npm install vite-plugin-mkcert --save-dev aus, um die neueste Version hinzuzufügen.
  • Öffnen Sie vite.config.ts und ersetzen Sie import basicSsl from '@vitejs/plugin-basic-ssl' durch import mkcert from'vite-plugin-mkcert'.
  • In plugins: [, ersetzen Sie basicSsl(), durch mkcert(),.
  • package.json sieht jetzt so aus:

• Führen Sie npm run start einmalig vom Terminal von VS Code aus aus.

  • Unter Windows öffnet sich ein neues Fenster und führt Sie durch die Erstellung und Installation des Zertifikats.
  • Unter MacOS fordert das Terminal Ihr Passwort an und generiert und installiert dann das Zertifikat.
  • Wenn Sie einen Fehler Error: Port 3000 is already in use erhalten, schließen Sie bitte den Server, der möglicherweise noch von Unity läuft.

• Das generierte Zertifikat wird automatisch auf der Maschine installiert, auf der Sie es generiert haben.

• Sie können den Terminalprozess wieder beenden.

• Von nun an verwendet das Drücken von Play in Unity/Blender das generierte Zertifikat für den lokalen Server, und es wird keine "Sicherheitswarnung" mehr angezeigt, da Ihr Browser nun die lokale Verbindung als vertrauenswürdig einstuft.

Installieren des Zertifikats auf Ihren Entwicklungsgeräten

Auf Ihren Entwicklungsgeräten müssen Sie das generierte Zertifikat installieren und dem OS erlauben, ihm zu vertrauen. Dies ist für jedes OS unterschiedlich. Für jedes benötigen Sie die generierte rootCA.pem Datei und senden sie an das Gerät, das Sie authentifizieren möchten.

Unter Windows: Finden Sie das Zertifikat in Users/<your-user>/.vite-plugin-mkcert/rootCA.pemUnter MacOS: Finden Sie das Zertifikat in Users/<your-user>/.vite-plugin-mkcert/rootCA.pem

Senden Sie die Datei an sich selbst (z. B. per E-Mail, AirDrop, iCloud, USB, Slack, ...), damit Sie auf Ihren Entwicklungsgeräten darauf zugreifen können.

Installieren des Zertifikats auf Android

1. Öffnen Sie die Datei. Sie werden aufgefordert, das Zertifikat zu installieren.

Installieren des Zertifikats auf iOS / iPadOS / VisionOS

1. Öffnen Sie die Datei.
2. Sie werden aufgefordert, das Profil zu Ihrem Gerät hinzuzufügen. Bestätigen Sie.
3. Gehen Sie zu den Einstellungen.
4. Es gibt einen neuen Eintrag "Profil". Wählen Sie ihn aus und erlauben Sie, dass das Profil für dieses Gerät aktiv ist.
5. Unter iOS / iPadOS müssen Sie auch "Root Certificate Trust" erlauben. Suchen Sie dazu nach Vertrauen oder gehen Sie zu Einstellungen > Allgemein > Info > Zertifikatvertrauenseinstellungen und aktivieren Sie volles Vertrauen für das Root-Zertifikat.

Installieren des Zertifikats auf einer anderen MacOS-Maschine

1. Öffnen Sie die Datei. Keychain Access öffnet sich und ermöglicht Ihnen die Installation des Zertifikats.
2. Möglicherweise müssen Sie "Vertrauen" auf "Immer erlauben" setzen.

Installieren des Zertifikats auf einer anderen Windows-Maschine

1. Öffnen Sie certmgr ("Benutzerzertifikate verwalten"), indem Sie Windows-Taste + certmgr eingeben.
2. Wählen Sie in der linken Seitenleiste "Vertrauenswürdige Stammzertifizierungsstellen" aus.
3. Klicken Sie mit der rechten Maustaste auf "Zertifikate" und wählen Sie "Alle Aufgaben > Importieren".
4. Wählen Sie die Datei rootCA.pem aus (möglicherweise müssen Sie den Dateityp auf "Alle" ändern) und folgen Sie den Anweisungen.

Seite automatisch mit KI übersetzt