Qu’est-ce qu’un imageset ?
Un imageset Xcode est un dossier de ressource nommé qui contient des fichiers image et une description Contents.json. Il se place dans un catalogue Assets.xcassets. L’application utilise le nom de la ressource, tandis que le catalogue décrit quel fichier fournit chaque échelle ou représentation.
L’export de ressources image iOS crée cette arborescence à partir d’un visuel que vous importez ou d’un résultat que vous avez déjà débloqué. Il peut empaqueter un SVG vectoriel simple ou générer des variantes PNG transparentes. Il ne transforme pas une photo en tracés vectoriels simplement en la plaçant dans un catalogue.
Choisissez le vectoriel pour un visuel simple et redimensionnable
Choisissez SVG vectoriel · iOS 13+ quand la source est un SVG composé de tracés pleins et de formes simples. L’export aplatit la géométrie prise en charge et écrit un imageset avec l’option Preserve Vector Data activée. Les ressources image SVG nécessitent iOS 13 ou une version ultérieure.
Le convertisseur utilise volontairement un sous-ensemble vectoriel restreint. Le texte doit d’abord être converti en contours, et les dégradés, masques, détourages et autres effets nécessitent une sortie PNG dans cet outil. Les fonctions non prises en charge produisent une erreur, pour que vous puissiez choisir une alternative adaptée. Tout ce qui est dangereux, comme un script, est retiré et listé ; lisez les avertissements avant d’importer les fichiers.
Un fichier vectoriel conserve une géométrie redimensionnable, mais il n’améliore pas le design pour autant. Un tracé trop compliqué, avec des milliers de minuscules formes, peut être moins utile qu’une image bitmap propre. Vérifiez l’image aux tailles réellement utilisées dans votre interface, surtout s’il y a des traits fins ou un petit lettrage.
Choisissez le PNG pour des ressources image à taille fixe
Les variantes PNG acceptent les sources SVG, PNG, JPEG, WebP et HEIC. Un SVG est rendu en PNG ; un PNG, JPEG, WebP ou HEIC importé voit ses métadonnées supprimées. La transparence est conservée. C’est utile quand un effet rendu compatible compte plus qu’une géométrie modifiable.
Le réglage de largeur est en points, pas en nombre final de pixels. Avec une largeur de 64 points, l’export produit ces fichiers :
| Échelle | Largeur en pixels | Nom de fichier |
|---|---|---|
| 1× | 64 | artwork@1x.png |
| 2× | 128 | artwork@2x.png |
| 3× | 192 | artwork@3x.png |
La hauteur suit les proportions d’origine. Une source deux fois plus haute que large donne une image de 64 × 128 pixels en 1×. Choisissez une largeur en points plus petite si une source haute risque de dépasser la hauteur maximale de l’export. Le réglage de largeur ne redimensionne pas un imageset vectoriel, qui garde son viewBox.
Importer sans remplacer votre catalogue
Décompressez le téléchargement et repérez Assets.xcassets/artwork.imageset, ou le dossier équivalent portant le nom de ressource que vous avez choisi. Faites glisser cet imageset dans votre catalogue existant. Ne remplacez pas tout le catalogue : il peut contenir des couleurs, des icônes et d’autres ressources dont votre app a déjà besoin.
En SwiftUI, une ressource nommée artwork se référence avec Image("artwork"). Appliquez dans l’app la mise en page et le redimensionnement voulus pour votre interface. Vérifiez la ressource importée dans Xcode et sur un appareil, y compris les bords transparents sur des surfaces claires et sombres.
Un imageset n’est pas un SF Symbol et n’hérite pas du fonctionnement propre à ce format de symboles. Il est aussi distinct de l’icône de lancement de l’app. Utilisez le générateur d’icônes d’app Android et iOS quand il vous faut un catalogue AppIcon, ou le convertisseur en VectorDrawable Android pour un drawable d’interface Android.