本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Amazon Q 开发者转换代码 GitHub
注意
Amazon Q 开发者版GitHub为预览版,可能会发生变化。
借助代码转换功能,您可以更新技术堆栈、增强性能并确保未来的兼容性,同时保留现有代码的核心功能。借助 Amazon Q Developer,您可以避免技术债务,构建应用程序以实现长期可持续性和可扩展性。
当您在议题中添加代码转换标签或使用/q transform
斜杠命令时,Amazon Q Developer 会将您的代码从 Java 版本 8 或 11 转换为版本 17。然后,Amazon Q Developer 会创建一个拉取请求,其中包含您可以合并到主线中的更改和更改摘要。
您可以让 Amazon Q Developer 每月执行有限次数的代码转换。您可以随时通过使用您的 AWS 账户注册安装的 Amazon Q Developer 应用程序来增加免费使用量。有关更多信息,请参阅 提高使用限制并在 Amazon Q 开发者控制台中配置详细信息。
先决条件
在使用 Amazon Q Developer 转换您的代码库之前,请考虑以下要求:
-
确保您的GitHub仓库已启用GitHub操作。有关更多信息,请参阅GitHub 文档中的了解 GitHub 操作
和启用工作流程 。 -
在
.github/workflows/
目录中创建和配置您的工作流程文件以处理代码转换任务。有关更多信息,请参阅 自定义代码转换工作流程。
满足先决条件后,您可以应用 Amazon Q 转换代理标签并升级存储库中的代码 GitHub 库。
重要
Amazon Q Developer 应用程序会尝试在您授权访问的 GitHub 存储库中自动创建 Amazon Q 开发代理和 Amazon Q 转换代理标签。如果标签不是自动创建的,或者它们是无意中删除的,则可以在中手动创建它们GitHub。这些标签必须命名为 Amazon Q 开发代理和 A mazon Q 转换代理,才能被识别为 Amazon Q 开发者标签并作为 Amazon Q 开发者标签进行处理。有关更多信息,请参阅GitHub 文档中的创建标签
升级您的代码库
-
如有必要,请使用您的GitHub凭证登录您的GitHub
账户。 -
导航到您的GitHub组织,然后导航到要转换代码库的存储库。
-
选择 “问题”,然后创建新问题。有关更多信息,请参阅GitHub 文档中的创建议题
。 -
在添加标题文本输入字段中,输入一个标题,该标题可为 Amazon Q Developer 提供代码转换的背景信息(例如:“升级代码库”)。还应包括问题描述,因为它还提供了上下文。
-
创建议题或配置现有议题时,您可以应用代码转换 Amazon Q Developer 标签或使用
/q transform
斜杠命令。请执行以下操作之一:-
要将标签应用于问题,请执行以下任一操作:
-
选择作为浏览器扩展程序提供的 “分配给 Amazon Q” 下拉菜单,然后选择 Amazon Q 转换代理标签。
-
在右侧菜单中,选择 “标签”,然后选择 Amazon Q 转换代理标签。
-
-
要在评论中使用
/q transform
斜杠命令,请执行以下操作:-
在问题中,导航到添加评论,然后在评论文本输入字段中输入
/q transform
。 -
选择评论。
-
-
-
选择 “创建问题” 以完成议题的创建,并提供必要的详细信息,以便 Amazon Q Developer 转换您的代码。
当 Amazon Q Developer 完成功能开发的代码更改生成后,它将对问题发表评论并打开拉取请求。
-
导航到 Amazon Q Developer 留下的评论(例如:
I finished upgrading your code and opened a pull request: Resolve Upgrade codebase.
“”),然后选择拉取请求链接。您也可以导航至 “拉取请求” 选项卡,然后选择 Amazon Q Developer 创建的拉取请求。
-
选择 “文件已更改” 选项卡以查看更改。
-
如果您对建议的代码更改感到满意,则可以合并拉取请求。有关更多信息,请参阅合并拉取请求
。
Amazon Q Developer 发表了一条评论,提供了转换摘要,其中包含有关其更新的文件的详细信息。您可以在评论中提供的build_logs.txt
文件中找到摘要。如果 Amazon Q Developer 无法执行完整的代码转换,它还会提供有关阻碍完整转换的错误的摘要。