Consommation et publication de packages Swift

Pour utiliser des packages Swift à partir d'un CodeArtifact dépôt

1. Si ce n'est pas le cas, suivez les étapes ci-dessous Configurez le gestionnaire de packages Swift avec CodeArtifact pour configurer le Swift Package Manager afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.

   Note

   Le jeton d'autorisation généré est valide pendant 12 heures. Vous devrez en créer un nouveau si 12 heures se sont écoulées depuis la création du jeton.

2. Modifiez le Package.swift fichier dans le dossier du projet de votre application pour mettre à jour les dépendances des packages à utiliser par votre projet.

   1. Si le Package.swift fichier ne contient pas de dependencies section, ajoutez-en une.

   2. Dans la dependencies section du Package.swift fichier, ajoutez le package que vous souhaitez utiliser en ajoutant son identifiant de package. L'identifiant du package se compose de la portée et du nom du package séparés par un point. Consultez l'extrait de code suivant une étape ultérieure pour un exemple.

      Astuce

      Pour trouver l'identifiant du package, vous pouvez utiliser la CodeArtifact console. Recherchez la version du package que vous souhaitez utiliser et consultez les instructions du raccourci d'installation sur la page de version du package.

   3. Si le Package.swift fichier ne contient pas de targets section, ajoutez-en une.

   4. Dans la targets section, ajoutez les cibles qui devront utiliser la dépendance.

      L'extrait suivant est un exemple d'extrait illustrant les sections configurées dependencies et les targets sections d'un fichier : Package.swift

      ...
          ],
          dependencies: [
              .package(id: "my_scope.package_name", from: "1.0.0")
          ],
          targets: [
            .target(
               name: "MyApp",
               dependencies: ["package_name"]
            ),...
          ],
      ...

3. Maintenant que tout est configuré, utilisez la commande suivante pour télécharger les dépendances du package depuis CodeArtifact.

   swift package resolve

Pour consommer des packages Swift à partir d'un CodeArtifact dépôt dans Xcode

1. Si ce n'est pas le cas, suivez les étapes ci-dessous Configurez le gestionnaire de packages Swift avec CodeArtifact pour configurer le Swift Package Manager afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.

   Note

   Le jeton d'autorisation généré est valide pendant 12 heures. Vous devrez en créer un nouveau si 12 heures se sont écoulées depuis la création du jeton.

2. Ajoutez les packages en tant que dépendance dans votre projet dans Xcode.

   1. Choisissez Fichier > Ajouter des packages.

   2. Recherchez votre package à l'aide de la barre de recherche. Votre recherche doit figurer dans le formulairepackage_scope.package_name.

   3. Une fois trouvé, choisissez le package et choisissez Ajouter un package.

   4. Une fois le package vérifié, choisissez les produits du package que vous souhaitez ajouter en tant que dépendance, puis choisissez Ajouter un package.

1. Si ce n'est pas le cas, suivez les étapes ci-dessous Configurez le gestionnaire de packages Swift avec CodeArtifact pour configurer le Swift Package Manager afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.

   Note

   Le jeton d'autorisation généré est valide pendant 12 heures. Vous devrez en créer un nouveau si 12 heures se sont écoulées depuis sa création.

2. Accédez au répertoire du projet Swift qui contient le Package.swift fichier de votre package.

3. Exécutez la swift package-registry publish commande suivante pour publier le package. La commande crée une archive source de package et la publie dans votre CodeArtifact dépôt.

   swift package-registry publish packageScope.packageName packageVersion

   Par exemple :

   swift package-registry publish myScope.myPackage 1.0.0

4. Vous pouvez vérifier que le package a été publié et qu'il existe dans le référentiel en vérifiant dans la console ou en utilisant la aws codeartifact list-packages commande suivante :

   aws codeartifact list-packages --domain my_domain --repository my_repo

   Vous pouvez répertorier la version unique du package à l'aide de la aws codeartifact list-package-versions commande suivante :

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name

1. Si ce n'est pas le cas, créez et mettez à jour les variables d'CODEARTIFACT_REPOenvironnement CODEARTIFACT_AUTH_TOKEN et en suivant les étapes décrites dansConfigurez le gestionnaire de packages Swift avec CodeArtifact.

   Note

   Le jeton d'autorisation est valide pendant 12 heures. Vous devrez actualiser votre variable d'CODEARTIFACT_AUTH_TOKENenvironnement avec de nouvelles informations d'identification si 12 heures se sont écoulées depuis sa création.

2. Tout d'abord, si aucun package Swift n'a été créé, vous pouvez le faire en exécutant les commandes suivantes :

   mkdir testDir && cd testDir
   swift package init
   git init .
   swift package archive-source

3. Utilisez la commande Curl suivante pour publier votre package Swift sur : CodeArtifact

   macOS and Linux

   curl -X PUT  --user "aws:$CODEARTIFACT_AUTH_TOKEN" \
   -H "Accept: application/vnd.swift.registry.v1+json" \
   -F source-archive="@test_dir_package_name.zip" \
   "${CODEARTIFACT_REPO}my_scope/package_name/packageVersion"

   Windows

   curl -X PUT  --user "aws:%CODEARTIFACT_AUTH_TOKEN%" \
   -H "Accept: application/vnd.swift.registry.v1+json" \
   -F source-archive="@test_dir_package_name.zip" \
   "%CODEARTIFACT_REPO%my_scope/package_name/packageVersion"

4. Vous pouvez vérifier que le package a été publié et qu'il existe dans le référentiel en vérifiant dans la console ou en utilisant la aws codeartifact list-packages commande suivante :

   aws codeartifact list-packages --domain my_domain --repository my_repo

   Vous pouvez répertorier la version unique du package à l'aide de la aws codeartifact list-package-versions commande suivante :

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name

Pour récupérer un package Swift GitHub et le republier dans CodeArtifact

1. Si ce n'est pas le cas, suivez les étapes ci-dessous Configurez le gestionnaire de packages Swift avec CodeArtifact pour configurer le Swift Package Manager afin d'utiliser votre CodeArtifact référentiel avec les informations d'identification appropriées.

   Note

   Le jeton d'autorisation généré est valide pendant 12 heures. Vous devrez en créer un nouveau si 12 heures se sont écoulées depuis la création du jeton.

2. Clonez le dépôt git du package Swift que vous souhaitez récupérer et republier à l'aide de la commande suivantegit clone. Pour plus d'informations sur le clonage de GitHub référentiels, consultez la section Clonage d'un référentiel dans la documentation. GitHub

   git clone repoURL

3. Accédez au référentiel que vous venez de cloner :

   cd repoName

4. Créez le package et publiez-le sur CodeArtifact.

   1. Recommandé : Si vous utilisez Swift 5.9 ou une version ultérieure, vous pouvez utiliser la swift package-registry publish commande suivante pour créer le package et le publier dans votre CodeArtifact référentiel configuré.

      swift package-registry publish packageScope.packageName versionNumber

      Par exemple :

      swift package-registry publish myScope.myPackage 1.0.0

   2. Si vous utilisez une version de Swift antérieure à la version 5.9, vous devez utiliser la swift archive-source commande pour créer le package, puis utiliser une commande Curl pour le publier.

      1. Si vous n'avez pas configuré les variables d'CODEARTIFACT_REPOenvironnement CODEARTIFACT_AUTH_TOKEN et, ou si cela fait plus de 12 heures que vous ne l'avez pas fait, suivez les étapes décrites dansConfigurer Swift sans la commande de connexion.

      2. Créez le package Swift à l'aide de la swift package archive-source commande :

         swift package archive-source

         En cas de succès, vous le verrez Created package_name.zip dans la ligne de commande.

      3. Utilisez la commande Curl suivante pour publier le package Swift sur : CodeArtifact

         macOS and Linux

         curl -X PUT  --user "aws:$CODEARTIFACT_AUTH_TOKEN" \
         -H "Accept: application/vnd.swift.registry.v1+json" \
         -F source-archive="@package_name.zip" \
         "${CODEARTIFACT_REPO}my_scope/package_name/packageVersion"

         Windows

         curl -X PUT  --user "aws:%CODEARTIFACT_AUTH_TOKEN%" \
         -H "Accept: application/vnd.swift.registry.v1+json" \
         -F source-archive="@package_name.zip" \
         "%CODEARTIFACT_REPO%my_scope/package_name/packageVersion"

5. Vous pouvez vérifier que le package a été publié et qu'il existe dans le référentiel en vérifiant dans la console ou en utilisant la aws codeartifact list-packages commande suivante :

   aws codeartifact list-packages --domain my_domain --repository my_repo

   Vous pouvez répertorier la version unique du package à l'aide de la aws codeartifact list-package-versions commande suivante :

   aws codeartifact list-package-versions --domain my_domain --repository my_repo \
   --format swift --namespace my_scope --package package_name