Qu'est-ce que le déploiement ?

Le déploiement est le processus qui consiste à rendre votre application disponible au public sur un site web. Needle Engine garantit que votre projet est aussi petit et rapide que possible en utilisant les dernières techniques de compression telles que KTX2, Draco, et Meshopt.

Cibles de déploiement disponibles

• Needle Cloud Idéal pour les applications web spatiales et le partage d'assets.

• Glitch Idéal pour l'expérimentation et le développement de code côté serveur.

• Netlify Idéal pour héberger votre propre site web et des noms de domaine personnalisés.

• itch.io Souvent utilisé pour les jeux.

• GitHub Pages Hébergement gratuit de pages statiques.

• Vercel Plateforme pour les développeurs frontend

• FTP Upload Déployez directement sur n'importe quel serveur avec support FTP. Les protocoles FTP et SFTP sont pris en charge.

• Build to folder Lorsque vous compilez vers un dossier, vous pouvez télécharger les fichiers sur n'importe quel serveur web ou autre service d'hébergement.

• Facebook Instant Games Plateforme de jeux sur Facebook et Facebook Messenger.

Compilations de développement (Development Builds)

Consultez les guides ci-dessus pour savoir comment accéder aux options depuis votre Éditeur (par exemple Unity ou Blender).

La principale différence avec une compilation de production est qu'elle ne réalise pas de compression ktx2 et draco (pour la réduction de la taille des fichiers et la vitesse de chargement), ainsi que l'option de charger progressivement les textures de haute qualité.

Nous recommandons généralement de réaliser des compilations de production pour une taille de fichier et une vitesse de chargement optimisées (voir plus d'informations ci-dessous).

Compilations de production (Production Builds)

Pour réaliser une compilation de production, vous devez avoir installé toktx, qui fournit la compression de textures en utilisant le format de supercompression KTX2. Veuillez vous rendre sur la page des versions de toktx et télécharger et installer la dernière version (v4.1.0 au moment de la rédaction). Vous devrez peut-être redémarrer Unity après l'installation. Si vous êtes certain d'avoir installé toktx et qu'il fait partie de votre PATH mais qu'il n'est toujours pas trouvé, veuillez redémarrer votre machine et réessayer la compilation.

Options d'optimisation et de compression

Compression de textures

Les compilations de production compresseront par défaut les textures en utilisant KTX2 (soit ETC1S soit UASTC selon leur utilisation dans le projet) mais vous pouvez également sélectionner la compression WebP et choisir un niveau de qualité.

Comment choisir entre la compression ETC1S, UASTC et WebP ?

Vous avez la possibilité de sélectionner les options de compression de textures et de chargement progressif par Texture en utilisant le Needle Texture Importer dans Unity ou dans l'onglet Material dans Blender.

Compression de maillages (Mesh compression)

Par défaut, une compilation de production compressera les maillages en utilisant la compression Draco. Utilisez le composant MeshCompression pour choisir entre draco et mesh-opt par glTF exporté. De plus, vous pouvez configurer la simplification de maillage pour réduire le nombre de polygones pour les compilations de production dans les paramètres d'importation de maillage (Unity). Lorsque vous visualisez votre application dans le navigateur, vous pouvez ajouter ?wireframe à votre URL pour prévisualiser les maillages.

Comment choisir entre Draco et Meshopt ?

Textures progressives (Progressive Textures)

Vous pouvez également ajouter le composant Progressive Texture Settings n'importe où dans votre scène, pour que toutes les textures de votre projet soient chargées progressivement. Le chargement progressif n'est pas appliqué aux lightmaps ni aux textures de skybox pour le moment.

Avec le chargement progressif, les textures seront d'abord chargées en utilisant une version de résolution inférieure. Une version de qualité complète sera chargée dynamiquement lorsque la texture deviendra visible. Cela réduit généralement considérablement le chargement initial de votre scène.

LODs de maillage automatiques (Level of Detail)

Depuis Needle Engine 3.36, nous générons automatiquement des maillages LOD et basculons entre eux à l'exécution. Les LODs sont chargés à la demande et uniquement lorsque nécessaire, donc cette fonctionnalité réduit à la fois votre temps de chargement et les performances.

Avantages clés

• Temps de chargement initial plus rapide
• Temps de rendu plus rapide grâce à moins de sommets à l'écran en moyenne
• Raycasting plus rapide grâce à l'utilisation des maillages LOD

Vous pouvez soit désactiver la génération de LOD pour l'ensemble de votre projet dans le composant Progressive Loading Settings, soit dans les paramètres du Mesh Importer.

Options de déploiement

Déployer sur Glitch 🎏

Glitch offre un moyen rapide et gratuit pour chacun d'héberger de petits et grands sites web. Nous offrons un moyen facile de remixer et de déployer sur une nouvelle page Glitch (basée sur notre modèle de départ), et aussi d'exécuter un serveur réseau minimaliste sur la même page Glitch si nécessaire.

Vous pouvez déployer sur Glitch en ajoutant le composant DeployToGlitch à votre scène et en suivant les instructions.

Notez que les projets gratuits hébergés sur Glitch ne doivent pas dépasser environ 100 Mo. Si vous avez besoin de téléverser un projet plus volumineux, envisagez d'utiliser une autre cible de déploiement.

Dépannage Glitch

Si vous cliquez sur Create new Glitch Remix et que le navigateur affiche une erreur comme there was an error starting the editor, vous pouvez cliquer sur OK. Ensuite, allez sur glitch.com et assurez-vous d'être connecté. Après cela, vous pouvez essayer de cliquer à nouveau sur le bouton dans Unity ou Blender.

Déployer sur Netlify

Déployer sur Vercel

1. Créez un nouveau projet sur vercel
2. Ajoutez votre projet web à un dépôt github
3. Ajoutez le dépôt à votre projet sur vercel

Voir notre projet exemple pour la configuration du projet

Déployer sur itch.io

Déployer sur FTP

Activation de gzip à l'aide d'un fichier .htaccess

Pour activer la compression gzip sur votre serveur FTP, vous pouvez créer un fichier nommé .htaccess dans le répertoire vers lequel vous souhaitez télécharger (ou un répertoire parent). Insérez le code suivant dans votre fichier .htaccess et enregistrez/téléchargez-le sur votre serveur :

<IfModule mod_mime.c>
RemoveType .gz
AddEncoding gzip .gz
AddType application/javascript .js.gz

Déployer sur Github Pages

Dépannage github pages

• J'ai déployé sur github pages mais aucune action ne s'exécute / le site web n'est pas en ligne
  • Si vous avez déployé pour la première fois, cela peut prendre quelques minutes avant que votre site web ne soit disponible. Vous pouvez vérifier l'onglet Actions sur github (/actions) pour voir le processus de déploiement.
  • Si votre site web n'est pas en ligne après quelques minutes ou si vous ne voyez aucune exécution de workflow dans l'onglet Actions sur github, alors allez sur la page des paramètres Github Pages (/settings/pages) et assurez-vous que la Branch est définie sur gh-pages.

Déployer sur Facebook Instant Games

Avec Needle Engine, vous pouvez compiler automatiquement pour Facebook Instant Games Aucun ajustement manuel de votre application ou jeu web n'est requis.

Compiler vers un dossier (Build To Folder)

Dans Unity, ouvrez File/Build Settings et sélectionnez Needle Engine pour les options :

Pour compiler votre projet web en vue de le télécharger sur n'importe quel serveur web, vous pouvez cliquer sur Build dans la fenêtre Build Settings de l'éditeur Unity. Vous pouvez cocher la case Development Build pour omettre la compression (voir ci-dessous), ce qui nécessite que toktx soit installé sur votre machine.

Pour prévisualiser localement votre compilation finale, vous pouvez utiliser le bouton Preview Build en bas de la fenêtre. Ce bouton effectuera d'abord une compilation normale, puis démarrera un serveur local dans le répertoire contenant les fichiers finaux afin que vous puissiez voir ce que vous obtenez une fois ces fichiers téléchargés sur votre serveur web.

Nodejs est uniquement requis pendant le développement. Le site web distribué (utilisant notre template vite par défaut) est une page statique qui ne dépend pas de Nodejs et peut être placée sur n'importe quel serveur web standard. Nodejs est requis si vous souhaitez exécuter notre serveur réseau minimaliste sur le même serveur web (automatiquement inclus dans le processus de déploiement Glitch).

Flux de travail de déploiement multiplateforme

Il est possible de créer des projets Unity réguliers où vous pouvez compiler à la fois pour Needle Engine et pour les plateformes Unity régulières telles que Desktop ou même WebGL. Notre approche de "mappage de composants" signifie qu'aucune logique d'exécution n'est modifiée à l'intérieur d'Unity - si vous le souhaitez, vous pouvez utiliser le mode Play (Play Mode) et compiler régulièrement pour d'autres plateformes cibles. Dans certains cas, cela signifiera que vous avez du code dupliqué (code C# et logique TypeScript correspondante). La quantité de travail supplémentaire qui en résulte dépend de votre projet.

Entrer en mode Play (Play Mode) dans Unity Dans Project Settings > Needle Engine, vous pouvez désactiver Override Play Mode et Override Build settings pour basculer entre le processus de compilation de Needle et le processus de compilation d'Unity :

Arguments de ligne de commande Needle Engine pour Unity

Needle Engine pour Unity prend en charge divers arguments de ligne de commande pour exporter des assets uniques (Prefabs ou Scenes) ou pour compiler un projet web entier en mode batch (sans fenêtre).

La liste suivante présente un tableau des options disponibles :

Page automatiquement traduite à l'aide de l'IA