创建代码检查任务

前提条件

• 已新建CodeArts项目。
• 如果使用的是代码托管服务（CodeArts Repo）的代码仓库，则可以参考代码托管服务的“用户指南 > 新建Repo代码仓库”，完成新建代码仓库。
• 如果使用的是第三方代码仓库，需已创建可用的代码仓库。

约束与限制

• 若删除的代码检查任务其代码仓为多分支代码仓，分支数量小于200时可删除成功，大于等于200会删除失败。
• 使用第三方代码仓库可能出现网络不稳定或其他问题，具体使用体验取决于第三方代码仓库网络环境和服务状态。

创建Repo代码源检查任务

在CodeArts Repo服务中创建云端仓库时，若勾选了“自动创建代码检查任务”，则代码仓库创建完成后，在代码检查任务列表可查看对应仓库的检查任务。

以下示例为在CodeArts Repo服务中创建云端仓库不勾选“自动创建代码检查任务”时，Repo代码源代码检查任务的创建步骤。

1. 访问CodeArts Check服务首页。
2. 在代码检查页面，单击“新建任务”，在“新建任务”页面，参考表1配置参数。

   表1 Repo代码源检查任务参数说明

   参数	说明
   所属项目	任务所属项目。 以项目入口方式访问CodeArts Check服务时默认填写，无需手动填写。 以服务入口访问时需根据实际情况选择新建项目中创建的项目。
   代码源	选择检查的代码源。 Repo：检查当前项目下Repo代码仓中的代码质量。
   任务名称	代码检查任务名称，可自定义。 支持中英文，数字，点，下划线“_”和连接符“-”。 字符长度范围为3~128。
   代码仓	选择需要检查的代码仓库。
   默认分支	选择需要检查的仓库分支。
   检查语言	选择需要检查的代码语言。当前支持检查的语言可参考支持主流开发语言。 当代码源是Repo时，检查语言会根据代码仓默认选择，只能减少语言，不能手动新增语言。

3. 单击“确定”，完成代码检查任务创建。可在代码检查任务列表页查看到该任务。
   • 创建代码检查任务后，如果您需要修改任务名称或默认分支，可在“代码检查详情”页面，选择“设置 > 基本信息”，修改任务名称和默认分支。
   • 对于不再继续使用的代码检查任务，可进入“代码检查详情”页面，选择“设置 > 基本信息”，删除当前代码检查任务。也可以单击代码检查任务所在行，在下拉框中，选择“删除”。

     若删除的代码检查任务其代码仓为多分支代码仓，分支数量小于200时可删除成功，大于等于200会删除失败。

创建第三方代码仓的代码检查任务

• 使用第三方代码仓库可能出现网络不稳定或其他问题，具体使用体验取决于第三方代码仓库网络环境和服务状态。
• 建议使用代码托管的代码导入功能，将代码导入到代码托管，实现安全、稳定、高效下载与构建。

1. 访问CodeArts Check服务首页。
2. 在代码检查页面，单击“新建任务”，在“新建任务”页面，参考表2配置参数。

   表2 第三方代码源检查任务参数说明

   参数	说明
   所属项目	任务所属项目。 以项目入口方式访问CodeArts Check服务时默认填写，无需手动填写。 以服务入口访问时需根据实际情况选择新建项目中创建的项目。
   代码源	选择检查的代码来源。 选择“通用Git”。对于托管在其他服务上的代码，可以使用通用Git连接实现代码拉取。
   任务名称	代码检查任务名称，可自定义。 支持中英文，数字，点，下划线“_”和连接符“-”。 字符长度范围为1~128。
   服务扩展点	选择连接到第三方代码仓库的服务扩展点。如果没有，可参考新建服务扩展点创建对应代码仓的服务扩展点。
   代码仓	选择需要检查的代码仓库。
   默认分支	选择需要检查的仓库分支。
   检查语言	选择需要检查的代码语言。当前支持检查的语言可参考支持主流开发语言。

3. 单击“确定”，代码检查任务创建完成。可在代码检查任务列表页查看到该任务。
   • 创建代码检查任务后，如果您需要修改任务名称或默认分支，可在“代码检查详情”页面，选择“设置 > 基本信息”，修改任务名称和默认分支。
   • 对于不再继续使用的代码检查任务，可进入“代码检查详情”页面，选择“设置 > 基本信息”，删除当前代码检查任务。也可以单击代码检查任务所在行，在下拉框中，选择“删除”。

     若删除的代码检查任务其代码仓为多分支代码仓，分支数量小于200时可删除成功，大于等于200会删除失败。

相关操作

• 创建代码检查任务相关API接口可参考新建检查任务。
• 任务管理的相关API接口可参考任务管理。
• 使用代码检查服务的相关最佳实践可参考代码检查最佳实践。
• 后续操作可参考配置代码检查任务。