設置套件儲存庫

2024/1/21 |

這個文章說明如何在 CLEAR Engine 上設置套件儲存庫。

在這個文章中，你將會學習如何：

  • 在 CLEAR Engine 上設置 Maven 和 NuGet 的套件目錄。

本文結束後，你將能夠在 CLEAR Engine 上設置套件目錄。

設置套件儲存庫位置

組建 .NET 和 Java 應用程式時，組建工具如 Maven 和 MSBuild 等可能會下載組建應用程式所需要的套件。因為 CLEAR Engine 是以一個服務帳戶執行，這些套件將被下載至服務帳戶的使用者資料目錄下的目錄中，例如 C:\Windows\ServiceProfiles\NetworkService 或 C:\Windows\SysWOW64\config\systemprofile。依照以下步驟變更組建工具儲存下載套件的位置：

  1. 以系統管理員身分開啟 PowerShell。

  2. 輸入以下命令：

     # Replace C:\ProgramData\Lucent Sky\CLEAR Engine if using a custom file system storage location
 $fileSystemStorage = "C:\ProgramData\Lucent Sky\CLEAR Engine"
 $gradleUserHome = "$fileSystemStorage\.gradle"
 $nugetPackages = "$fileSystemStorage\.nuget\packages"
 [System.Environment]::SetEnvironmentVariable('GRADLE_USER_HOME', "$gradleUserHome", [System.EnvironmentVariableTarget]::Machine)
 [System.Environment]::SetEnvironmentVariable('NUGET_PACKAGES', "$nugetPackages", [System.EnvironmentVariableTarget]::Machine)
 Stop-Service "CLEAR Engine"; Start-Service "CLEAR Engine"

  3. 在 PowerShell 中，輸入以下命令來以文字編輯器開啟 Apache Maven 的設定檔案：

     Invoke-Item "C:\Program Files\Lucent Sky\CLEAR Engine\Tools\apache-maven-*\conf\settings.xml"

  4. 在 settings.xml 中，找出 <localRepository> 標籤並將其移出註解，再將它的值設定為 Maven 儲存下載套件的位置，例如 C:\ProgramData\Lucent Sky\CLEAR Engine\.m2\repository。

  5. 在 PowerShell 中，輸入以下命令來以文字編輯器開啟 sbt 的設定檔案：

     Invoke-Item "C:\Program Files\Lucent Sky\CLEAR Engine\Tools\sbt-*\conf\sbtconfig.txt"

  6. 將以下內容加到 sbtconfig.txt 的最後：

     # Replace C:\ProgramData\Lucent Sky\CLEAR Engine in the following lines if using a custom file system storage location
 -Dsbt.boot.directory="C:\ProgramData\Lucent Sky\CLEAR Engine\.sbt\boot"
 -Dsbt.global.base="C:\ProgramData\Lucent Sky\CLEAR Engine\.sbt"
 -Dsbt.ivy.home="C:\ProgramData\Lucent Sky\CLEAR Engine\.ivy2"
 -Dsbt.repository.config="C:\ProgramData\Lucent Sky\CLEAR Engine\.sbt\repositories"

設定遠端儲存庫

自 Lucent Sky AVM 版本 2112 開始，包含的 Apache Maven 不再支援使用 HTTP 的自訂儲存庫。因此若專案使用來自使用 HTTP 的自訂儲存庫中的相依性，Maven 組建將會失敗。這可已從 Maven 記錄檔中存在 maven-default-http-blocker (http://0.0.0.0/) 確認。

使用者應將這些自訂儲存庫移轉至 HTTPS。若無法移轉，依照以下步驟啟用使用 HTTP 的自訂儲存庫：

  1. 以系統管理員身分開啟 PowerShell。

  2. 輸入以下命令來以文字編輯器開啟 Apache Maven 的設定檔案：

     Invoke-Item "C:\Program Files\Lucent Sky\CLEAR Engine\Tools\apache-maven-*\conf\settings.xml"`
  3. 在 settings.xml 中，找出一個含有 <id>maven-default-http-blocker</id> 的 <mirror> 標籤。將此 <mirror> 改為註解來停用它。