View a markdown version of this page

Konfiguration und Verwendung von Gradle Groovy - Amazon CodeCatalyst
Abhängigkeiten werden abgerufen von CodeCatalystPlugins werden abgerufen von CodeCatalystAbrufen von Paketen aus externen Paket-Repositorys über CodeCatalystPakete veröffentlichen in CodeCatalystEinen Gradle-Build in IntelliJ IDEA ausführen

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfiguration und Verwendung von Gradle Groovy

Um Gradle Groovy mit zu verwenden CodeCatalyst, müssen Sie Gradle Groovy mit Ihrem Paket-Repository verbinden und ein persönliches Zugriffstoken (PAT) für die Authentifizierung bereitstellen. Anweisungen zum Verbinden von Gradle Groovy mit Ihrem Paket-Repository finden Sie in der Konsole. CodeCatalyst

Abhängigkeiten werden abgerufen von CodeCatalyst

Die folgenden Anweisungen erklären, wie Sie Gradle Groovy so konfigurieren, dass Abhängigkeiten aus Ihrem Paket-Repository abgerufen werden. CodeCatalyst

Um Gradle Groovy zum Abrufen von Abhängigkeiten aus Ihrem Paket-Repository zu verwenden CodeCatalyst

  1. Öffnen Sie die Konsole unter. CodeCatalyst https://codecatalyst.aws/

  2. Navigieren Sie zu Ihrem Projekt.

  3. Wählen Sie im Navigationsbereich Packages (Pakete) aus.

  4. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

  5. Wählen Sie Mit Repository verbinden.

  6. Wählen Sie im Dialogfeld Mit Repository verbinden Gradle Groovy aus der Liste der Paketmanager-Clients aus.

  7. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie Gradle Groovy authentifizieren können. CodeCatalyst Wenn Sie bereits einen haben, können Sie ihn verwenden. Wenn nicht, können Sie hier eine erstellen.

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre PAT zu kopieren.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

  8. Aktualisieren Sie Ihre Gradle-Eigenschaftendatei mit Ihren Zugangsdaten. usernameErsetzen Sie es durch Ihren CodeCatalyst Benutzernamen und PAT ersetzen Sie es durch Ihr CodeCatalyst persönliches Zugriffstoken. Sie können jeden spaceUsername Wert verwenden, spacePassword solange Sie in den folgenden Schritten dieselben Werte verwenden.

    spaceUsername=username
spacePassword=PAT

  9. Um Abhängigkeiten aus CodeCatalyst einem Gradle-Build abzurufen, kopieren Sie den maven Codeausschnitt und fügen Sie ihn dem repositories Abschnitt in der Datei Ihres Projekts hinzu. build.gradle Ersetzen Sie die folgenden Werte. Sie können jeden Wert verwenden, spaceName solange Sie in den folgenden Schritten dieselben Werte verwenden.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen Sie es space_name durch Ihren CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den Namen Ihres CodeCatalyst Paket-Repositorys.

    maven {
  name = 'spaceName'
  url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
  credentials(PasswordCredentials)
}

  10. (Optional) Um das CodeCatalyst Paket-Repository als einzige Quelle für Ihre Projektabhängigkeiten zu verwenden, entfernen Sie alle anderen Abschnitte in den Repositorys aus der build.gradle Datei. Wenn Sie mehr als ein Repository haben, durchsucht Gradle jedes Repository in der Reihenfolge, in der sie aufgelistet sind, nach Abhängigkeiten.

Plugins werden abgerufen von CodeCatalyst

Standardmäßig löst Gradle Plugins aus dem öffentlichen Gradle Plugin Portal auf. Die folgenden Schritte konfigurieren Ihr Gradle-Projekt so, dass Plugins aus Ihrem CodeCatalyst Paket-Repository aufgelöst werden.

Um Gradle zum Abrufen von Plugins aus Ihrem Paket-Repository zu verwenden CodeCatalyst

  1. Öffnen Sie die CodeCatalyst Konsole unter. https://codecatalyst.aws/

  2. Navigieren Sie zu Ihrem Projekt.

  3. Wählen Sie im Navigationsbereich Packages (Pakete) aus.

  4. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

  5. Wählen Sie Mit Repository verbinden.

  6. Wählen Sie im Dialogfeld Mit Repository verbinden Gradle aus der Liste der Paketmanager-Clients aus.

  7. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie Gradle authentifizieren können. CodeCatalyst Wenn Sie bereits einen haben, können Sie ihn verwenden. Wenn nicht, können Sie hier eine erstellen.

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre PAT zu kopieren.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

  8. Aktualisieren Sie Ihre Gradle-Eigenschaftendatei mit Ihren Zugangsdaten. usernameErsetzen Sie es durch Ihren CodeCatalyst Benutzernamen und PAT ersetzen Sie es durch Ihr CodeCatalyst persönliches Zugriffstoken. Sie können jeden spaceUsername Wert verwenden, spacePassword solange Sie in den folgenden Schritten dieselben Werte verwenden.

    spaceUsername=username
spacePassword=PAT

  9. Fügen Sie Ihrer settings.gradle Datei einen pluginManagement Block hinzu. Der pluginManagement Block muss vor allen anderen Anweisungen erscheinensettings.gradle. Ersetzen Sie die folgenden Werte.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • spaceNameErsetzen Sie durch den im vorherigen Schritt verwendeten Namenswert.

    • Ersetzen Sie ihn space_name durch Ihren CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den Namen Ihres CodeCatalyst Paket-Repositorys.

    pluginManagement {
    repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

    Dadurch wird sichergestellt, dass Gradle Plugins aus dem angegebenen Repository auflöst. Das Repository muss über eine Upstream-Verbindung verfügen, die zum Gradle Plugin Portal (gradle-plugins-store) konfiguriert ist, damit häufig benötigte Gradle-Plugins für den Build verfügbar sind. Weitere Informationen finden Sie in der Gradle-Dokumentation.

Abrufen von Paketen aus externen Paket-Repositorys über CodeCatalyst

Sie können Maven-Pakete aus öffentlichen Repositorys über ein CodeCatalyst Repository installieren, indem Sie es mit einer Upstream-Verbindung zu dem Gateway konfigurieren, das das Gateway-Repository darstellt. Pakete, die aus dem Gateway-Repository installiert wurden, werden aufgenommen und in Ihrem Repository gespeichert. CodeCatalyst

CodeCatalyst unterstützt die folgenden öffentlichen Maven-Paket-Repositorys.

  • Maven-Central-Gateway

  • Google-Android-Gateway

  • Gradle-Plugins-Gateway

  • Commonsware-Gateway

Um Pakete aus öffentlichen Maven-Paket-Repositorys zu installieren

  1. Falls Sie es noch nicht getan haben, konfigurieren Sie Gradle mit Ihrem CodeCatalyst Paket-Repository, indem Sie den Schritten unter oder folgen. Abhängigkeiten werden abgerufen von CodeCatalyst Plugins werden abgerufen von CodeCatalyst

  2. Stellen Sie sicher, dass Ihr Repository das Gateway-Repository, von dem Sie installieren möchten, als Upstream-Verbindung hinzugefügt hat. Du kannst dies tun, indem du den Anweisungen in folgst Ein Upstream-Repository hinzufügen und das öffentliche Paket-Repository auswählst, das du als Upstream hinzufügen möchtest.

Weitere Hinweise zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unterEine Paketversion mit Upstream-Repositorys anfordern.

Pakete veröffentlichen in CodeCatalyst

In diesem Abschnitt wird beschrieben, wie eine mit Gradle Groovy erstellte Java-Bibliothek in einem Repository veröffentlicht wird. CodeCatalyst

Um Gradle Groovy zu verwenden, um Pakete in einem Paket-Repository zu veröffentlichen CodeCatalyst

  1. Öffnen Sie die Konsole unter CodeCatalyst . https://codecatalyst.aws/

  2. Wählen Sie auf der Übersichtsseite für Ihr Projekt Pakete aus.

  3. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

  4. Wählen Sie Mit Repository verbinden.

  5. Wählen Sie im Dialogfeld Mit Repository verbinden Gradle Groovy aus der Liste der Paketmanager-Clients aus.

  6. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie Gradle authentifizieren können. CodeCatalyst Wenn Sie bereits einen haben, können Sie ihn verwenden. Wenn nicht, können Sie hier eine erstellen.

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre PAT zu kopieren.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

  7. Aktualisieren Sie Ihre Gradle-Eigenschaftendatei mit Ihren Zugangsdaten. usernameErsetzen Sie es durch Ihren CodeCatalyst Benutzernamen und PAT ersetzen Sie es durch Ihr CodeCatalyst persönliches Zugriffstoken. Sie können jeden spaceUsername Wert verwenden, spacePassword solange Sie in den folgenden Schritten dieselben Werte verwenden.

    spaceUsername=username
spacePassword=PAT

  8. Fügen Sie das maven-publish Plugin zum plugins Abschnitt der build.gradle Projektdatei hinzu.

    plugins {
    id 'java-library'
    id 'maven-publish'
}

  9. Als Nächstes fügen Sie der build.gradle Projektdatei einen publishing Abschnitt hinzu. Ersetzen Sie die folgenden Werte.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen Sie es space_name durch Ihren CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den Namen Ihres CodeCatalyst Paket-Repositorys.

    publishing {
    publications {
        mavenJava(MavenPublication) {
            groupId = 'group-id'
            artifactId = 'artifact-id'
            version = 'version'
            from components.java
        }
    }
    repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

    Das maven-publish Plugin generiert eine POM-Datei auf der Grundlage vongroupId, undartifactId, die im publishing Abschnitt version angegeben sind.

  10. Nachdem diese Änderungen abgeschlossen build.gradle sind, führen Sie den folgenden Befehl aus, um das Projekt zu erstellen und in das Repository hochzuladen.

    ./gradlew publish

  11. Navigieren Sie in der CodeCatalyst Konsole zu Ihrem Paket-Repository, um zu überprüfen, ob das Paket erfolgreich veröffentlicht wurde. Sie sollten das Paket in der Paketliste Ihres Paket-Repositorys sehen.

Weitere Informationen finden Sie in den folgenden Themen auf der Gradle-Website:

Einen Gradle-Build in IntelliJ IDEA ausführen

Sie können einen Gradle-Build in IntelliJ IDEA ausführen, der Abhängigkeiten von abruft. CodeCatalyst Um Gradle mit zu authentifizieren CodeCatalyst, müssen Sie ein persönliches Zugriffstoken (PAT) verwenden. Sie können Ihre CodeCatalyst PAT in gradle.properties oder einer separaten Datei Ihrer Wahl speichern.

Methode 1: Fügen Sie das PAT in gradle.properties ein

Verwenden Sie diese Methode, wenn Sie die gradle.properties Datei nicht verwenden und ihren Inhalt mit Ihrem PAT überschreiben können. Wenn Sie diese Methode verwendengradle.properties, können Sie diese Methode so ändern, dass die PAT hinzugefügt wird, anstatt den Inhalt der Datei zu überschreiben.

Anmerkung

Das Beispiel zeigt die gradle.properties Datei, die sich in GRADLE_USER_HOME befindet.

Erstellen Sie zunächst eine PAT, falls Sie keine haben.

Um ein persönliches Zugriffstoken (PAT) zu erstellen

  1. Wählen Sie in der oberen Menüleiste Ihr Profil-Badge aus und wählen Sie dann Meine Einstellungen aus.

    Tipp

    Du findest dein Benutzerprofil auch, indem du auf der Mitgliederseite eines Projekts oder Bereichs deinen Namen aus der Mitgliederliste auswählst.

  2. Geben Sie im Feld PAT-Name einen beschreibenden Namen für Ihren PAT ein.

  3. Belassen Sie unter Ablaufdatum das Standarddatum oder wählen Sie das Kalendersymbol, um ein benutzerdefiniertes Datum auszuwählen. Das Ablaufdatum ist standardmäßig auf ein Jahr ab dem aktuellen Datum festgelegt.

  4. Wählen Sie Erstellen aus.

    Sie können dieses Token auch erstellen, wenn Sie Repository klonen für ein Quell-Repository wählen.

  5. Speichern Sie das PAT-Geheimnis an einem sicheren Ort.

    Wichtig

    Das PAT-Geheimnis wird nur einmal angezeigt. Sie können es nicht abrufen, nachdem Sie das Fenster geschlossen haben.

Aktualisieren Sie als Nächstes Ihre build.gradle Datei mit dem folgenden Snippet:

repositories {
    maven {
        name = 'spaceName'
        url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
        credentials(PasswordCredentials)
    }
}

Methode 2: Fügen Sie das PAT in eine separate Datei ein

Verwenden Sie diese Methode, wenn Sie Ihre gradle.properties Datei nicht ändern möchten.

Erstellen Sie zunächst eine PAT, falls Sie keine haben.

Um ein persönliches Zugriffstoken (PAT) zu erstellen

  1. Wählen Sie in der oberen Menüleiste Ihr Profil-Badge aus und wählen Sie dann Meine Einstellungen aus.

    Tipp

    Du findest dein Benutzerprofil auch, indem du auf der Mitgliederseite eines Projekts oder Bereichs deinen Namen aus der Mitgliederliste auswählst.

  2. Geben Sie im Feld PAT-Name einen beschreibenden Namen für Ihren PAT ein.

  3. Belassen Sie unter Ablaufdatum das Standarddatum oder wählen Sie das Kalendersymbol, um ein benutzerdefiniertes Datum auszuwählen. Das Ablaufdatum ist standardmäßig auf ein Jahr ab dem aktuellen Datum festgelegt.

  4. Wählen Sie Erstellen aus.

    Sie können dieses Token auch erstellen, wenn Sie Repository klonen für ein Quell-Repository wählen.

  5. Speichern Sie das PAT-Geheimnis an einem sicheren Ort.

    Wichtig

    Das PAT-Geheimnis wird nur einmal angezeigt. Sie können es nicht abrufen, nachdem Sie das Fenster geschlossen haben.

Um Ihre PAT in einer separaten Datei abzulegen

  1. Aktualisieren Sie Ihre build.gradle Datei mit dem folgenden Snippet. Ersetzen Sie space_nameproj_name, und repo_name durch Ihren CodeCatalyst Benutzernamen, Bereichsnamen, Projektnamen und Namen des Paket-Repositorys.

    def props = new Properties()
file("fileName").withInputStream { props.load(it) }
                  
repositories {
        maven {
            name = 'spaceName'
            url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/')
            credentials(PasswordCredentials)
        }
    }
}

  2. Schreiben Sie Ihre PAT in die Datei, die in Ihrer build.gradle Datei angegeben wurde:

    echo "codecatalystArtifactsToken=PAT" > fileName