更新时间:2024-12-02 GMT+08:00

缓存目录使用说明

CodeArts Build在部分构建步骤中提供了依赖缓存的能力,能够极大提升用户构建时依赖包的下载效率,进而提升构建效率。用户在执行构建任务时,CodeArts Build在构建任务执行机上以租户维度进行远端缓存目录挂载,构建时直接使用,无需重复下载。当前支持缓存能力的构建步骤表1

执行缓存清理操作前,请务必仔细阅读以下缓存清理风险以及注意事项:

  • 由于缓存目录为同租户共享,频繁清理缓存会概率性导致同租户用户构建异常(常表现为“xxx文件不存在”),因此只可在缓存异常时清理,任务执行成功后务必再次编辑任务,删除清理命令,并且在执行清理缓存操作的同时,不要执行其他的使用缓存的编译构建任务。
  • 出于安全考虑,缓存清理命令只可在对应构建步骤里执行,在其他步骤执行此命令会导致“目录不存在”或”清理无效”等报错。
表1 各构建步骤缓存目录使用说明

构建步骤

缓存目录(只能填写绝对目录,禁止填写“./”开头的相对目录)

缓存使用方式

清理缓存命令

Maven构建

/repository/local/maven

图形化配置方式,参考使用Maven构建

rm -rf /repository/local/maven/{groupId}/{artifactId}/{version},需填入的参数分别对应依赖包坐标中的groupId、artifactId和version,其中groupId中的点会被自动分割为层级目录。

若依赖包如下:

<dependency> 
   <groupId>com.codearts.java</groupId>
   <artifactId>demo</artifactId>
   <version>1.0-SNAPSHOT</version> 
</dependency>

则清理该依赖包所需命令为:rm -rf /repository/local/maven/com/codearts/java/demo/1.0-SNAPSHOT

NPM构建

/npmcache

构建命令行输入:npm config set cache /npmcache

npm cache clean --force

Grunt构建

/npmcache

构建命令行输入:npm config set cache /npmcache

npm cache clean --force

gulp构建

/npmcache

构建命令行输入:npm config set cache /npmcache

npm cache clean --force

Android快应用构建

/npmcache

构建命令行输入:npm config set cache /npmcache

npm cache clean --force

Yarn构建

/npmcache

构建命令行输入:yarn config set cache-folder /npmcache

yarn cache clean

Gradle构建

(仅限使用gradle wrapper版本)

./gradle/wrapper

构建命令行输入:cp /cache/android/wrapper/gradle-wrapper.jar ./gradle/wrapper/gradle-wrapper.jar

rm -rf ./gradle/wrapper/

Android构建

(仅限使用gradle wrapper版本)

./gradle/wrapper

构建命令行输入:cp /cache/android/wrapper/gradle-wrapper.jar ./gradle/wrapper/gradle-wrapper.jar

rm -rf ./gradle/wrapper/