Qu'est-ce que le format de fichier UNITYPACKAGE ?
Un fichier .unitypackage est le format propriétaire de Unity Technologies pour l'empaquetage et la distribution de ressources Unity entre les projets et via l'Asset Store. Sous le capot, il s'agit d'une archive TAR compressée en gzip - renommez le fichier en .tar.gz et n'importe quel outil tel que 7-Zip pourra le décompresser, mais les ressources ne se reproduisent correctement que lorsqu'elles sont importées via l'Unity Editor.
À l'intérieur, l'archive contient un répertoire par ressource, nommé par le GUID 128 bits de la ressource. Chaque répertoire contient :
- les octets de données brutes de la ressource
- un fichier
.metaportant le GUID et les paramètres d'importation - une entrée texte
pathnameenregistrant le chemin relatif au projet d'origine - une vignette optionnelle
preview.png
Cette disposition permet à Unity de reconstruire la structure de dossiers d'origine et de garder intactes les références entre ressources lors de l'importation. Pour importer, faites glisser le fichier sur la fenêtre de l'Unity Editor ou utilisez Assets > Import Package.
Le .unitypackage est l'unité de distribution standard de l'Unity Asset Store depuis son lancement en 2010 et reste pris en charge dans Unity 6. Il coexiste avec le format plus récent Unity Package Manager (UPM), qui remplace cette approche par une archive tar simple et un manifeste package.json installé via la fenêtre du Package Manager plutôt que par importation directe.
L'archive porte une somme de contrôle CRC-32 gzip mais ne comprend aucune signature cryptographique, l'auteur ne peut donc pas être vérifié sans outils externes.
Sécurité et sûreté
RISQUE : MEDIUMUn .unitypackage peut contenir des scripts C# (.cs), des scripts d'éditeur et des DLL qui s'exécutent dans l'Unity Editor lors de l'importation - ainsi, un paquet malveillant peut exécuter du code dans votre projet, et pas seulement ajouter des éléments graphiques inertes. N'importez des paquets que de sources de confiance (l'Unity Asset Store officiel vérifie les soumissions ; les paquets de forums ou torrents aléatoires ne le font pas). Examinez les scripts/DLL inclus avant l'importation, et traitez un paquet téléchargé comme n'importe quel code tiers. L'extraire d'abord en tant que .tar.gz vous permet d'inspecter ce qu'il contient.
Détails du format
en brefProgrammes qui ouvrent les fichiers UNITYPACKAGE
Détails techniques
spécifications approfondies| Format de conteneur | archive tar POSIX compressée en gzip, équivalente à un fichier .tar.gz |
| Octets magiques | 0x1F 0x8B à l'offset d'octet 0 (signature gzip standard) |
| Compression | gzip / DEFLATE appliqué à l'ensemble du flux de l'archive |
| Structure interne | Un répertoire par ressource, chaque répertoire nommé par le GUID 128 bits de la ressource |
| Entrées par ressource | Fichier de données de ressource, fichier .meta (GUID + paramètres d'importation), fichier texte pathname et une vignette preview.png optionnelle |
| Identification des ressources | Chaque ressource se voit attribuer un GUID 128 bits stocké dans son fichier .meta d'accompagnement ; les GUID survivent aux transferts entre projets |
| Restauration du chemin | Une entrée texte pathname à l'intérieur de chaque dossier GUID enregistre le chemin relatif au projet d'origine, utilisé pour reconstruire la disposition des dossiers lors de l'importation |
| Vérification d'intégrité | CRC-32 gzip sur le flux compressé ; aucune signature cryptographique ou signature de code n'est appliquée |
| Chiffrement | Aucun - pas de chiffrement intégré ; le contenu de l'archive est entièrement lisible après décompression |
| Type MIME | application/octet-stream (principal) ; application/gzip également utilisé par certains hôtes |
| Taille de fichier typique | De quelques dizaines de kilo-octets à plusieurs giga-octets, selon le volume de textures, de modèles et d'audio inclus |
| Prise en charge des plateformes | Windows, macOS et Linux - partout où l'Unity Editor ou un outil capable de lire le tar est disponible |
| Méthode d'importation | Faites glisser le fichier sur la fenêtre de l'Unity Editor, ou utilisez Assets > Import Package dans la barre de menus |
| Relation avec UPM | Distinct des paquets Unity Package Manager, qui utilisent une archive tar simple avec un manifeste package.json et sont installés via la fenêtre du Package Manager plutôt qu'importés comme ressources |
| Publié | Mid-2000s (Unity asset export; Asset Store launched 2010) |
| Dernière version | Legacy .unitypackage export (current Unity 6); coexists with the newer UPM/tarball package format |
| Spécification | docs.unity3d.com |
Conversions UNITYPACKAGE
Q&R de la communauté
posées par les utilisateursPas encore de questions - soyez le premier à poser une question sur les fichiers UNITYPACKAGE.