配置和使用搖籃 - Amazon CodeCatalyst

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

配置和使用搖籃

要使用搖籃 Groovy 與 CodeCatalyst,你必須搖籃 Groovy 連接到你的包存儲庫,並提供一個個人訪問令牌(PAT)進行身份驗證。您可以查看在 CodeCatalyst 控制台中將搖籃 Groovy 連接到您的軟件包存儲庫的說明。

從中獲取依賴關係 CodeCatalyst

下面的說明解釋了如何配置搖籃 Groovy 獲取依賴關係 CodeCatalyst 包存儲庫。

要使用搖籃 Groovy 從您的 CodeCatalyst 軟件包存儲庫中獲取依賴關係
  1. 開啟主 CodeCatalyst 控台,網址為 https://codecatalyst.aws/

  2. 導航到您的項目。

  3. 在導覽窗格中,選擇 Packages (套件)

  4. 從套裝程式儲存區域清單中選擇套裝程式儲存區域。

  5. 選擇「Connect 至儲存庫」。

  6. Connect 到存儲庫對話框中,從軟件包管理器客戶端列表中選擇搖籃 Groovy

  7. 您將需要一個個人訪問令牌(PAT)來驗證搖籃 Groovy。 CodeCatalyst如果你已經有一個,你可以使用它。如果沒有,您可以在此處創建一個。

    1. 選擇 [建立權杖]。

    2. 選擇「複製」以複製您的PAT.

      警告

      關閉對話方塊後,您將無法PAT再次看到或複製您的。

  8. 使用您的訪問憑據更新您的 gradle 屬性文件。Replace (取代) username 使用您的 CodeCatalyst 用戶名並替換 PAT 使用您的 CodeCatalyst 個人訪問令牌。您可以使用任何值 spaceUsername 以及 spacePassword 只要您在以下步驟中使用相同的值即可。

    spaceUsername=username spacePassword=PAT
  9. 要從 Gradle 構建 CodeCatalyst 中獲取依賴關係,請複製maven代碼片段並將其添加到項目build.gradle文件中的repositories部分。取代下列值。您可以使用任何值 spaceName 只要您在以下步驟中使用相同的值即可。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) space_name 使用您的 CodeCatalyst空間名稱。

    • Replace (取代) proj_name 用你的 CodeCatalyst項目名稱。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

    maven { name = 'spaceName' url = uri('https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/') credentials(PasswordCredentials) }
  10. (選擇性) 若要使用 CodeCatalyst 套裝程式儲存庫做為專案相依性的唯一來源,請從build.gradle檔案中移除儲存庫中的任何其他區段。如果您有多個存儲庫,Gradle 會按照列出的順序搜索每個存儲庫中的依賴關係。

從中獲取插件 CodeCatalyst

默認情況下搖籃將解決從公共搖籃插件門戶插件插件。以下步驟配置您的 Gradle 項目以解決 CodeCatalyst 包存儲庫中的插件。

使用 Gradle 從您的 CodeCatalyst 軟件包存儲庫中獲取插件
  1. 開啟主 CodeCatalyst 控台,網址為 https://codecatalyst.aws/

  2. 導航到您的項目。

  3. 在導覽窗格中,選擇 Packages (套件)

  4. 從套裝程式儲存區域清單中選擇套裝程式儲存區域。

  5. 選擇「Connect 至儲存庫」。

  6. 在「Connect 到存儲庫」對話框中,從軟件包管理器客戶端列表中選擇 Gradle

  7. 您將需要一個個人訪問令牌(PAT)來對 Gradle 進行身份驗證。 CodeCatalyst如果你已經有一個,你可以使用它。如果沒有,您可以在此處創建一個。

    1. 選擇 [建立權杖]。

    2. 選擇「複製」以複製您的PAT.

      警告

      關閉對話方塊後,您將無法PAT再次看到或複製您的。

  8. 使用您的訪問憑據更新您的 gradle 屬性文件。Replace (取代) username 使用您的 CodeCatalyst 用戶名並替換 PAT 使用您的 CodeCatalyst 個人訪問令牌。您可以使用任何值 spaceUsername 以及 spacePassword 只要您在以下步驟中使用相同的值即可。

    spaceUsername=username spacePassword=PAT
  9. settings.gradle檔案中新增pluginManagement區塊。pluginManagement區塊必須出現在中的任何其他陳述式之前settings.gradle。取代下列值。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) spaceName 與上一步中使用的名稱值。

    • Replace (取代) space_name 使用您的 CodeCatalyst空間名稱。

    • Replace (取代) proj_name 用你的 CodeCatalyst項目名稱。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

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

    這將確保 Gradle 解析指定存儲庫中的插件。存儲庫必須配置到 Gradle 插件門戶(gradle-plugins-store)的上游連接,以便構建常見需要的 Gradle 插件可用。如需詳細資訊,請參閱 Gradle 文件

從外部套裝程式儲存區域擷取套裝程式 CodeCatalyst

您可以使用代表閘道儲 CodeCatalyst存庫之閘道的上游連線來設定儲存庫,透過儲存庫從公用儲存庫安裝 Maven 套件。從閘道儲存庫安裝的套件會擷取並儲存在您的存 CodeCatalyst放庫中。

CodeCatalyst 支持以下公共 Maven 軟件包存儲庫。

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • 通用网关

若要從公用 Maven 套件儲存庫安裝套件
  1. 如果您還沒有,請按照從中獲取依賴關係 CodeCatalyst從中獲取插件 CodeCatalyst中的步驟使用您的 CodeCatalyst 軟件包存儲庫配置 Gradle。

  2. 確定您的存放庫已新增要從中安裝的閘道儲存庫作為上游連線。您可以按照中的說明進行操作,新增上游存放庫並選擇要新增為上游的公用套件存放庫。

如需有關從上游存放庫要求套件的詳細資訊,請參閱請求具有上游存儲庫的軟件包版本

將套件發佈至 CodeCatalyst

本節介紹如何發布與搖籃 Groovy 建立到一個存儲庫中的 Java CodeCatalyst 庫。

要使用搖籃 Groovy 將軟件包發佈到軟件 CodeCatalyst 包存儲庫
  1. 開啟主 CodeCatalyst 控台,網址為 https://codecatalyst.aws/

  2. 在專案的概觀頁面上,選擇 [套件]。

  3. 從套裝程式儲存區域清單中選擇套裝程式儲存區域。

  4. 選擇「Connect 至儲存庫」。

  5. Connect 到存儲庫對話框中,從軟件包管理器客戶端列表中選擇搖籃 Groovy

  6. 您將需要一個個人訪問令牌(PAT)來對 Gradle 進行身份驗證。 CodeCatalyst如果你已經有一個,你可以使用它。如果沒有,您可以在此處創建一個。

    1. 選擇 [建立權杖]。

    2. 選擇「複製」以複製您的PAT.

      警告

      關閉對話方塊後,您將無法PAT再次看到或複製您的。

  7. 使用您的訪問憑據更新您的 gradle 屬性文件。Replace (取代) username 使用您的 CodeCatalyst 用戶名並替換 PAT 使用您的 CodeCatalyst 個人訪問令牌。您可以使用任何值 spaceUsername 以及 spacePassword 只要您在以下步驟中使用相同的值即可。

    spaceUsername=username spacePassword=PAT
  8. maven-publish插件添加到plugins項目build.gradle文件的部分。

    plugins { id 'java-library' id 'maven-publish' }
  9. 接下來,將publishing剖面加入至專案build.gradle檔案。取代下列值。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • Replace (取代) space_name 使用您的 CodeCatalyst空間名稱。

    • Replace (取代) proj_name 用你的 CodeCatalyst項目名稱。

    • Replace (取代) repo_name 使用您的 CodeCatalyst軟件包存儲庫名稱。

    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) } } }

    maven-publish外掛程POM式會根據publishing區段中version指定的groupIdartifactId、和來產生檔案。

  10. 完成這些變更build.gradle之後,請執行下列命令來建置專案並將其上傳到存放庫。

    ./gradlew publish
  11. 在 CodeCatalyst 主控台中瀏覽至您的套裝程式儲存區域,以檢查套件是否已成功發佈。您應該會在套件儲存庫的「套件」清單中看到套件。

有關更多信息,請參閱 Gradle 網站上的以下主題:

在 IntelliJ 中運行搖籃構建 IDEA

您可以在 IntelliJ 中運行一個 Gradle 構建,從中提IDEA取依賴關係。 CodeCatalyst要使用對 Gradle 進行身份驗證 CodeCatalyst,您必須使用個人訪問令牌(PAT)。您可以將您的存儲 CodeCatalyst PAT在gradle.properties或您選擇的單獨文件中。

方法 1:放PAT入 gradle.properties

如果您不使用該gradle.properties文件,並且可以使用PAT. 如果您使用的是gradle.properties,您可以修改此方法以新增,PAT而不是覆寫檔案的內容。

注意

此範例顯示位於中的gradle.properties檔案GRADLE_USER_HOME

首先,PAT如果您沒有,請創建一個。

若要建立個人存取權杖 (PAT)
  1. 在頂端選單列中,選擇您的設定檔徽章,然後選擇 [我的設定]

    提示

    您還可以通過轉到項目或空間的成員頁面並從成員列表中選擇您的名稱來查找您的用戶個人資料。

  2. PAT名稱中,輸入您的PAT.

  3. 到期日中,保留預設日期,或選擇行事曆圖示以選取自訂日期。到期日預設為從目前日期算起一年。

  4. 選擇 Create (建立)。

    當您為來源儲存庫選擇複製儲存庫時,也可以建立此權杖。

  5. 將PAT秘密保存在安全的位置。

    重要

    PAT密碼只會顯示一次。關閉視窗之後,您無法擷取它。

接下來,使用以下代碼片段更新您的build.gradle文件:

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

方法 2:將其放PAT在單獨的文件中

如果您不想修改gradle.properties檔案,請使用此方法。

首先,PAT如果您沒有,請創建一個。

若要建立個人存取權杖 (PAT)
  1. 在頂端選單列中,選擇您的設定檔徽章,然後選擇 [我的設定]

    提示

    您還可以通過轉到項目或空間的成員頁面並從成員列表中選擇您的名稱來查找您的用戶個人資料。

  2. PAT名稱中,輸入您的PAT.

  3. 到期日中,保留預設日期,或選擇行事曆圖示以選取自訂日期。到期日預設為從目前日期算起一年。

  4. 選擇 Create (建立)。

    當您為來源儲存庫選擇複製儲存庫時,也可以建立此權杖。

  5. 將PAT秘密保存在安全的位置。

    重要

    PAT密碼只會顯示一次。關閉視窗之後,您無法擷取它。

將您的文件放PAT在單獨的文件中
  1. 使用以下代碼片段更新您的build.gradle文件。Replace (取代) space_name, proj_namerepo_name 使用您的 CodeCatalyst 用戶名,空間名稱,項目名稱和軟件包庫名稱。

    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. PAT將您的文件寫入文件中指定的build.gradle文件中:

    echo "codecatalystArtifactsToken=PAT" > fileName