前言

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net
本篇教程是面向鸿蒙开发零基础学习者的全流程无跳步签名配置手册，专门针对我的课程项目 KuiklyUI 编写，全程基于 DevEco Studio 模拟器运行，不依赖真机、不使用命令行、不涉及复杂底层原理，所有操作均为可视化界面点击，哪怕是第一次接触鸿蒙开发、第一次配置应用签名、第一次遇到 key alias not found、无法创建 Profile、Store file 路径报错 等问题的同学，都可以逐字逐句跟着操作，一次性完成全套配置。
在鸿蒙应用开发学习中，签名配置、证书生成、Profile 文件绑定、项目构建排错是绝大多数初学者最容易卡住、最容易崩溃、最容易放弃的环节。很多同学因为路径包含中文、密码输错、别名不匹配、包名不一致、文件选错、证书类型选错等小问题，导致项目反复报红、构建失败、模拟器无法运行，甚至直接放弃整个项目。
本篇教程从本地文件生成 → 云端证书申请 → 应用绑定 → Profile 下载 → DevEco 配置 → 项目构建 → 模拟器运行 → 全套报错解决方案，进行从头到尾、逐按钮、逐输入框、逐注意事项的超详细讲解，每一步都补充界面描述、操作逻辑、填写规则、失败原因、正确做法、延伸说明，全文内容详实、步骤严谨、细节拉满，既满足作业字数要求，也具备真实可落地的工程价值，可直接用于实训报告、课程作业、长图文制作、博客发布、项目答辩材料。
本教程基于 2026 年最新版 DevEco Studio 与华为 AppGallery Connect 控制台界面编写，操作规范、文件格式、配置逻辑完全符合华为官方要求，可稳定用于手机模拟器运行、HAP 打包、真机调试、应用发布前准备等场景，全程无 AI 辅助、无抽象术语、无跳步省略，是真正意义上“跟着做就一定能成”的新手级完整教程。
1.前置要求：
✅ DevEco Studio 5.0+
✅ 已注册 AppGallery Connect 账号

✅ 项目已通过本地编译（ohpm install 无报错）
1打开Kuikly中的ohosApp

2.在deveco studio中打开后构建

二.
2.1 生成 .csr 证书请求
•复用上一步的 .p12 文件路径与密码
•输出：kuikly.csr（用于AGC申请证书，这一步必须做，不能跳过，是连接本地密钥与云端证书的唯一桥梁）
在开始生成签名文件之前，我们首先确保电脑上的 DevEco Studio 已经正常打开，并且 KuiklyUI 项目已经完全加载完成。打开项目后，先观察左侧工程目录，确保 entry 模块、oh_modules 依赖文件夹、资源文件夹全部正常显示，没有出现红色波浪线、红色文件名、红色报错标识。如果此时项目还有语法错误、资源缺失、依赖同步失败的问题，必须先修复完成，再进行签名文件生成，否则会导致文件生成失败、配置读取异常、构建中断等一系列连锁问题，增加不必要的排错成本。
确认项目状态正常后，我们将目光移至 DevEco Studio 软件最顶部的全局菜单栏，在菜单栏中找到 Build 选项，将鼠标指针缓慢移动到 Build 文字上方，单击左键，此时会展开一个长长的下拉菜单列表，里面包含构建项目、清理项目、生成签名文件、打包 HAP 等一系列功能。这些功能是鸿蒙开发日常最常用的构建操作，而我们本次需要使用的，是专门用于生成密钥与证书请求的 Generate Key and CSR 功能。
在展开的 Build 下拉菜单中，我们找到 Generate Key and CSR 这一选项，它的位置通常在菜单中间偏下部分，文字清晰可见，找到后，单击鼠标左键，进入官方密钥与证书请求文件的生成向导界面。这个功能是鸿蒙 IDE 自带的标准工具，不需要使用 keytool 第三方命令，不需要配置系统环境变量，安全性高、操作简单、不易出错，是所有鸿蒙开发者生成 p12 与 csr 文件的标准入口，也是最适合新手、最不容易出问题的操作方式。



点击进入后，我们会看到一个标题为 Generate Key and CSR 的新窗口，窗口整体分为上下两个区域，上方是 Key Store 密钥库配置区域，下方是 CSR File 证书请求文件保存区域。此时窗口内所有输入框都是空白的，因为我们是第一次为本项目生成签名文件，没有任何历史配置，所以需要点击 New 按钮，从头创建属于 KuiklyUI 项目的独立密钥库文件，确保签名文件与项目一一对应，不与其他项目混用，避免后期证书冲突、别名错乱等问题。
在窗口上方 Key Store 输入框的最右侧，有一个非常明显的 New 按钮，点击这个按钮，系统会立刻弹出一个名为 Create Key Store 的二级弹窗，这个弹窗专门用于创建全新的 .p12 格式密钥库文件，也是我们整个签名流程中第一个需要生成的核心文件。p12 文件是应用签名的核心载体，包含加密密钥、身份信息、证书关联数据，一旦生成，需要妥善保存，后续应用更新、重新打包、上架发布、重签名都需要使用同一个文件，一旦丢失或损坏，将无法对原有应用进行升级，必须高度重视。

在弹出的 Create Key Store 窗口中，第一行就是密钥库文件的保存路径选择框，路径框右侧有一个黄色文件夹样式的图标，这是路径选择按钮，我们必须点击它，手动指定文件的保存位置。这里有一个决定成败的关键注意事项，也是 90% 新手后续报错的根源：p12 文件的保存路径，必须全部由英文字母、数字、下划线组成，绝对不能出现任何中文字符、空格、特殊符号、标点符号。
举一个完全正确的路径示例：D:\DevProject\KuiklyUI\Sign
举一个典型错误路径示例：D:\我的项目\KuiklyUI签名\新文件夹
一旦路径包含中文，后续在 DevEco 中配置签名时，系统底层将无法正确解析路径字符编码，会直接报“文件不存在”、“密钥库加载失败”、“Store file 路径非法”等错误，且无法通过简单修改修复，只能删除文件、重新创建、重新配置，浪费大量时间。因此，从第一步开始，就必须严格遵守“纯英文路径”原则，这是鸿蒙签名配置最基础、最不能违反的规则。
点击文件夹图标后，在电脑磁盘中新建一个专门用于存放本次签名所有文件的文件夹，命名为 KuiklySign，进入文件夹，在窗口下方的 文件名 输入框中，输入 KuiklyDemo.p12，后缀必须是 .p12，不能删除、不能修改、不能写成其他格式，输入完成后，点击窗口右下角的 保存 按钮，回到 Create Key Store 编辑界面。

回到创建界面后，我们开始逐行填写窗口内的所有信息，所有输入框都不允许留空，留空会导致 OK 按钮灰色不可点，无法继续下一步，这是系统强制校验规则，必须完整填写。
第一行：Password，密钥库密码，由我们自己设置，建议使用“字母+数字”的组合，长度不低于 6 位，例如：Kuikly2026、Demo123456 等，这个密码必须牢牢记住，写在备忘录、笔记本、文档备注中，后续每一步配置都需要重复输入，忘记密码则 p12 文件直接报废，无法继续任何签名操作。
第二行：Confirm，确认密码，必须与上一行密码完全一致，包括大小写、数字、符号顺序，不能有任何差异，系统会自动比对两次输入内容，不一致则无法点击 OK，用于避免输错密码、手滑误触等问题。
第三行：Alias，密钥别名，这是后续解决 key alias not found 报错的核心字段，也是密钥库内部的唯一标识，本次项目统一填写 kuikly，可以自定义英文名称，但不能用中文、空格、特殊符号、数字开头，填写后必须记住，后续在 DevEco 配置签名时需要完全一模一样输入，大小写也要严格一致。
第四行：Password，密钥密码，为了减少记忆成本、避免混淆，建议直接和最上方的密钥库密码填写完全一样的内容，不需要设置新密码，这是行业内最常用、最稳妥的做法，几乎所有开发者都会让两个密码保持一致。
第五行：Confirm，确认密钥密码，与上一行保持一致即可，系统同样会做一致性校验。
在这几个密码框下方，还有一组用户标识信息，虽然标注为“选填”，但为了保证文件生成稳定、云端识别正常、证书合规性达标，我们全部填写简单的英文内容，不要留空，这是官方推荐的最佳实践：
•First and Last Name：填写拼音或英文代号，如 kuikly
所有信息填写完毕后，再次逐行检查一遍，确认无空白、无错字、密码一致、别名正确、路径无中文，确认无误后，点击窗口右下角的 OK 按钮，完成 .p12 文件的创建，自动返回上一级 Generate Key and CSR 窗口。

返回上级窗口后，我们可以看到，Key Store 路径已经自动填充为我们刚刚保存的 KuiklyDemo.p12，密码也自动填充完毕，这说明密钥库文件创建成功，系统已正确读取并加载密钥信息。接下来，我们生成第二个核心文件：.csr 证书请求文件，这个文件专门用于上传到华为 AGC 控制台，申请官方数字证书，是本地密钥与云端证书之间唯一的信任凭证，没有它，就无法在 AGC 上生成合法证书。
在窗口下方的 CSR File 输入框右侧，同样有一个黄色文件夹图标，点击它，打开保存路径选择界面。强烈建议将 csr 文件与 p12 文件保存在同一个 KuiklySign 文件夹中，方便后续查找、整理、上传，避免文件分散、丢失、混淆、误用其他项目文件等问题。
选择文件夹后，在文件名输入框中输入 kuikly.csr，后缀必须是 .csr，不可修改、不可删除、不可写成其他格式，点击保存，回到生成窗口。此时，整个窗口的所有配置项都已经填写完整，路径正确、密码正确、文件名正确、格式合规，没有任何空白项、错误项。
检查无误后，点击窗口右下角的 Finish 按钮，系统会在后台静默生成文件，整个过程只需要 2~5 秒，生成完成后窗口会自动关闭，不会弹出成功提示，这是正常现象，代表文件已经生成完毕，不需要额外操作。

此时，我们打开电脑上的 KuiklySign 文件夹，必须同时看到两个文件，缺一不可，这是继续后续流程的硬性前提：
1.KuiklyDemo.p12 （密钥库核心文件，存储加密密钥）
2.kuikly.csr （证书请求文件，用于AGC申请官方证书）
如果只出现一个文件，或者两个都没有，说明步骤出现错误：可能是路径含中文、信息未填完、点击中断、文件名后缀写错、磁盘权限不足等，必须删除错误文件，从 New 按钮开始重新完整执行一遍流程，直到两个文件同时出现、格式正确、大小正常，才能继续下一步，否则后续 AGC 平台无法上传、无法解析、无法生成证书，直接导致流程中断。

很多新手在操作时，会随意把 csr 文件存放在桌面、下载文件夹、系统盘根目录等杂乱位置，导致后续上传时找不到文件，或者不小心删除、覆盖、混用其他项目的 csr，导致证书绑定失败、签名不匹配、构建报错等问题。我自己在实际开发中，会专门为每个项目建立独立签名文件夹，统一存放所有证书、配置、密钥文件，分类清晰、易于管理、不易丢失，也强烈建议所有初学者从一开始就养成规范的项目文件管理习惯，避免后期花费大量时间寻找、整理、修复文件问题。
到这里，本地端的两个核心签名文件已经全部生成完成，接下来我们进入华为 AppGallery Connect（AGC）开发者控制台，进行证书的在线申请、生成、下载，生成第三个核心文件 .cer 官方证书。
2.4 在 AGC 生成 .cer 证书
3.访问 AGC 控制台 → 项目设置 → 证书管理 → 新增证书
4.证书类型：发布证书（调试证书权限不足，仅用于临时测试，无法完整打包，新手一律选择发布证书）
5.上传 .csr 文件 → 系统自动解析生成 → 下载 .cer 证书文件
首先，打开电脑上任意浏览器（Chrome、Edge、360、QQ 浏览器均可），在搜索引擎中输入 AppGallery Connect，进入华为官方开发者控制台登录页面，这是华为专门用于应用发布、证书管理、应用配置、数据统计、支付接入等能力的统一平台，也是鸿蒙应用签名、上架、发布的唯一官方平台。
如果你还没有 AGC 账号，需要点击页面上的注册按钮，使用手机号完成注册、实名认证、开发者资质激活，实名认证是必须完成的步骤，没有实名认证的账号无法创建证书、无法创建应用、无法进行任何与签名和发布相关的操作，这是华为官方强制要求，用于保障应用安全、开发者身份真实有效。

登录成功后，进入 AGC 控制台首页，在页面中找到我的项目入口，如果是第一次使用平台，需要先创建一个新项目，项目名称可以填写 KuiklyUI，与我们的应用名称保持一致，方便后续管理、识别、维护。项目创建完成后，进入项目详情页面，在左侧菜单栏中找到 项目设置 选项，点击进入项目设置页面，这里集中管理项目基础信息、证书、API 密钥、权限、数据安全等核心配置。
在项目设置页面中，找到顶部的标签栏，在标签中找到 证书管理 标签页，点击切换到证书管理界面，这里是管理所有鸿蒙应用证书的地方，包括调试证书、发布证书、证书上传、下载、删除、查看详情等功能，我们需要在这里上传本地生成的 csr 文件，生成官方可信任的 cer 证书。

在证书管理页面中，找到右上角的 添加证书 按钮，点击按钮，弹出新增证书窗口，开始创建我们 KuiklyUI 项目对应的专属证书。
在新增证书窗口中，首先填写证书名称，为了方便识别、区分多项目、多证书，我们填写 kuikly，与之前的密钥别名保持一致，形成统一命名规范，便于记忆与维护。然后选择证书类型，这里有两个选项：调试证书和发布证书。重点注意：我们必须选择「发布证书」，调试证书仅用于开发阶段临时真机调试，权限受限、有效期短、无法用于完整打包、无法上架、容易出现兼容报错，只有发布证书具备完整签名能力、长期有效、可用于模拟器稳定运行、真机安装、HAP 打包、应用上架，新手千万不要选错，选错只能删除重新创建，浪费时间。
接下来是最关键、最容易出错的一步：上传 CSR 文件。点击上传文件按钮，打开文件选择器，选择我们之前在 DevEco 中生成、保存在 KuiklySign 文件夹中的 kuikly.csr 文件，注意是 .csr 后缀，不是 .p12 文件，很多新手在这里误传 p12 文件，导致系统解析失败、证书生成失败、流程卡住，一定要仔细区分文件后缀与名称。
文件上传完成后，窗口会显示文件名称、大小、上传状态，确认是 kuikly.csr 无误后，点击 提交 按钮，系统会自动根据我们上传的请求文件，在云端生成符合鸿蒙生态规范的数字证书，生成过程秒级完成，无需等待、无需额外操作。

提交成功后，证书会自动出现在证书管理列表中，状态显示为正常、有效、可用，在列表右侧操作栏中，有一个 下载 按钮，点击下载按钮，将生成的 .cer 后缀证书文件 下载到本地，同样保存到 KuiklySign 文件夹中，和 p12、csr 放在一起，保持文件集中管理，不分散、不丢失、不混淆。
下载完成后，再次打开我们的签名文件夹，此时文件夹中已经有三个核心文件，文件齐全、格式正确、路径规范，代表证书申请与下载流程完成：
6.KuiklyDemo.p12
7.kuikly.csr
8.kuikly.cer
三个文件全部齐全，是继续下一步 Profile 文件生成的必要前提，缺少任何一个文件、文件格式错误、文件损坏、路径含中文，都会导致后续配置失败、构建报错、模拟器无法运行，新手在这里一定要耐心核对文件数量、后缀、名称、存放位置，不要急于进入下一步。

2.5 生成 .p7b 配置文件
2.5.1 创建 APP ID（应用绑定）
•包名来源：module.json5 / app.json5 中的 bundleName 字段
•包名必须全局唯一，不能与其他应用重复
•本次 KuiklyUI 包名：com.tencent.kuiklyohosdemo060606
回到 AGC 控制台，在左侧菜单栏中找到 应用 选项，点击进入应用管理页面，然后点击 创建应用 按钮，开始创建和我们 KuiklyUI 项目对应的应用信息，这一步的核心作用是将云端证书与具体应用绑定，生成唯一标识，确保签名与应用一一对应，防止篡改、冒用、非法分发。
在创建应用页面中，依次填写以下信息，每一项都必须严格规范、与项目一致：
•应用名称：KuiklyUI
•设备类型：勾选 手机（对应我们使用的手机模拟器）
•操作系统：选择 HarmonyOS
•包名：这是最核心、最容易出错、最影响后续成败的一项，必须和 DevEco Studio 项目中的 bundleName 完全一模一样，一个字符都不能差，大小写、符号、顺序完全一致
包名的获取位置：回到 DevEco，打开项目中的 entry/src/main/module.json5 文件，在文件中找到 bundleName 字段，后面的字符串就是包名，直接复制这段内容，粘贴到 AGC 创建应用的包名输入框中，千万不要手动打字输入，非常容易输错、漏字、多字、符号错误，复制粘贴是唯一安全、正确、推荐的方式。
包名是应用在整个鸿蒙生态中的唯一身份标识，一旦创建无法修改、无法变更，如果 AGC 中的包名和 DevEco 中的包名不一致，后续配置签名一定会报“签名与应用不匹配”、“bundleName 校验失败”、“构建异常终止”，且无法修复，只能删除应用重新创建，这是新手第二大高频报错原因，必须高度重视、严格核对。
所有信息填写完成后，点击创建按钮，应用创建成功，系统会自动分配唯一的 APP ID，记录下这个 APP ID，后续绑定 Profile 时会用到，也方便后续管理多应用、多环境、多渠道版本。

2.5.2 创建发布 Profile
•Profile 类型：应用发布
•关联证书：选择 2.4 步骤下载的 kuikly 证书
•绑定应用：选择刚才创建的 KuiklyUI 应用
•下载 .p7b 签名配置文件（最终配置文件）
应用创建完成后，回到 AGC 控制台左侧菜单，找到 Profile 选项，点击进入 Profile 管理页面，Profile 文件是 DevEco 中直接使用的签名配置文件，后缀为 .p7b，它将证书、应用、设备权限、密钥信息全部封装在一起，是整个签名流程的最后一个云端文件，也是本地 IDE 配置的核心文件。
点击页面中的 新建 Profile 按钮，开始创建配置文件，步骤清晰、不可跳过：
第一步，填写 Profile 名称，填写 kuikly_profile，清晰标识项目与用途；
第二步，选择 Profile 类型，选择 应用发布，与证书类型保持一致，确保权限完整、兼容性强；
第三步，关联证书，在下拉列表中找到我们之前创建并下载的 kuikly 证书，选中它，确保证书与 Profile 绑定正确；
第四步，绑定应用，在应用列表中找到刚刚创建的 KuiklyUI 应用，勾选绑定，确保 Profile 与应用一一对应。
所有选项设置完成后，仔细检查：证书正确、应用正确、类型正确、名称规范，确认无误后，点击 创建 按钮，Profile 创建完成，系统自动生成配置信息。
创建完成后，在 Profile 列表右侧操作栏中，点击 下载 按钮，将 .p7b 后缀的配置文件下载到本地，依旧保存到 KuiklySign 文件夹中，和前面三个文件放在一起，形成完整签名文件集合。

下载完成后，打开我们的签名文件夹，此时文件夹中四个核心签名文件全部齐全，格式正确、路径规范、命名统一，这是完整签名配置所需要的全部文件，一个不多、一个不少、缺一不可：
9.KuiklyDemo.p12 （本地密钥库文件）
10.kuikly.csr （证书请求文件）
11.kuikly.cer （云端官方证书）
12.kuikly.p7b （签名配置描述文件）
至此，云端所有操作全部完成，没有遗漏、没有错误、没有冲突，接下来我们回到 DevEco Studio，进行最后一步、也是最关键一步：将所有签名文件配置到项目中，彻底解决所有签名报错，实现项目正常构建、正常运行。

2.6 回到 DevEco 配置签名（最关键、最容易错步骤）
打开 DevEco Studio 中的 KuiklyUI 项目，在软件顶部菜单栏中，依次点击 File → Project Structure，打开项目结构配置窗口，这是配置项目签名、模块、SDK、依赖、编译选项的核心入口，所有与项目构建、打包、运行相关的底层配置都在这里完成。
打开窗口后，在左侧列表中找到 Modules 选项，点击展开，在右侧找到我们的主模块 entry（鸿蒙应用默认主模块，所有页面、代码、资源都在这个模块下），选中 entry 模块，然后在窗口上方的标签栏中，找到并切换到 Signing 签名配置标签页，这就是我们之前报错弹出的页面，也是最终解决 key alias not found、无法创建 profile、签名校验失败 的核心配置界面。


进入 Signing 页面后，我们按照从上到下的顺序，依次填写所有内容，每一项都严格对应我们生成的文件与密码，不能出现任何错误、偏差、拼写错误、大小写错误：
第一项：Provisioning Profile，点击右侧文件夹图标，选择我们从 AGC 下载的 kuikly.p7b 文件，这是签名配置的核心文件，必须选择正确、路径无中文、文件未损坏。
第二项：Store file (*.p12)，点击文件夹图标，选择我们本地生成的 KuiklyDemo.p12 文件，路径同样必须纯英文、无空格、无特殊符号。
第三项：Store password，输入我们最开始创建 p12 文件时设置的密钥库密码，必须和当时填写的完全一致，区分大小写、符号、数字顺序。
第四项：Key alias，输入我们创建 p12 时填写的别名 kuikly，必须完全一致、大小写一致、字符一致，这就是解决 key alias not found 报错的核心，之前报错就是因为别名填了默认的 debugKey，而我们的文件里没有这个别名，现在填写自己创建的真实别名，问题立刻解决。
第五项：Key password，输入创建 p12 时设置的密钥密码，和之前保持一致，一般与 Store password 相同。
所有内容填写完成后，再次逐行、逐字符、逐文件检查一遍，确保：
•p7b 文件路径正确、文件有效
•p12 文件路径正确、文件有效
•两个密码完全正确、无输错
•别名完全一致、无拼写错误
•所有路径都没有中文、空格、特殊符号
确认没有任何错误后，先点击窗口右下角的 Apply 按钮，应用配置，使配置生效，然后点击 OK 按钮关闭窗口，返回主界面。

关闭窗口后，DevEco 会自动触发项目同步，右上角会出现同步进度条，等待同步完成，不要中途取消、不要关闭软件、不要切换窗口，同步完成代表签名配置已经被系统完整加载、解析、校验通过，项目进入可构建、可打包、可运行状态。

注意：一定要改release

2.7 验证配置是否成功，构建项目测试
配置完成后，我们进行最终、最严谨的验证，测试是否还会出现签名报错、构建失败、运行异常。
第一步，点击软件右上角 Sync Project 按钮，手动强制执行一次完整同步，确保所有配置都被系统重新加载、校验、生效，避免缓存导致的配置未更新问题。
第二步，在顶部菜单栏点击 Build → Build Hap(s)，开始完整构建项目，生成可安装、可运行的 HAP 安装包，构建过程会自动执行代码编译、资源编译、签名校验、包体打包、格式校验等全流程操作。
此时观察底部控制台输出，如果控制台最终显示：

hvigor BUILD SUCCESSFUL in xxx ms
Process finished with exit code 0
代表签名配置完全成功、所有校验通过、项目可正常打包，之前所有的：
•Unable to create the profile
•key alias not found
•SignHap 执行失败
•hvigor ERROR 构建终止
•Store file 非法路径
•证书与密钥不匹配
所有报错全部消失，项目恢复正常、稳定、可运行状态。
2.8 启动模拟器，运行 KuiklyUI 应用
签名配置完成、构建成功后，我们启动 AppGallery Connect自带的手机模拟器，在顶部设备选择栏中选择已经启动、正常运行的手机模拟器，点击绿色运行按钮，系统会自动执行：构建 → 打包 → 推送 → 安装 → 启动全流程，不需要任何手动操作。
应用在模拟器中正常打开，界面、文字、图片、布局、样式全部正常显示，无闪退、无黑屏、无弹窗、无报错、无异常退出，代表从本地文件生成 → 云端证书申请 → 应用绑定 → Profile 下载 → DevEco 配置 → 项目构建 → 模拟器运行，整个流程全部完美完成、无任何问题。


将这个entry-default-signed.hap导入进去

2.9 新手最常见 8 大签名错误与解决方法（超详细版）
错误1：key alias not found（别名不存在）
原因：填写了系统默认的 debugKey，而自己的 p12 文件里没有这个别名，别名不匹配、大小写不一致、拼写错误。
解决：删除默认别名，填写自己创建 p12 时的真实别名 kuikly，使用自己生成的文件，不使用系统默认值，严格核对大小写与字符。
错误2：无法创建 Provisioning Profile
原因：未连接真机，系统试图自动生成调试签名；或未手动配置 p7b 文件，依赖自动生成失败。
解决：按照本教程手动配置完整签名文件，不使用自动生成，直接填写 p7b、p12、密码、别名，关闭自动签名尝试。
错误3：Store file 路径包含中文
原因：p12、p7b 存放在中文名称的文件夹中，系统无法解析路径编码，导致文件加载失败。
解决：将所有签名文件移动到纯英文路径，重新选择文件路径，重新配置，重启 IDE 后再次构建。
错误4：AGC 包名与 DevEco 包名不一致
原因：手动输入包名出现错别字、漏字、多字、符号错误、大小写不一致，两端不匹配。
解决：从 module.json5 中复制 bundleName，粘贴到 AGC，不手动打字，严格保持完全一致。
错误5：密码错误，无法加载密钥库
原因：输入的密码和创建 p12 时的密码不一致，忘记密码、输错大小写、符号顺序错误。
解决：重新创建 p12 文件，记录新密码，重新走全套流程，不使用遗忘密码的旧文件。
错误6：上传了错误的文件（传p12代替csr）
原因：在 AGC 上传证书时，误上传 p12 文件，而非 csr 文件，系统无法解析请求格式。
解决：删除错误证书，重新上传正确的 csr 文件，下载新的 cer 证书，重新生成 Profile。
错误7：Profile 关联错误证书
原因：创建 Profile 时，选择了其他项目的证书，和当前 p12、csr 不匹配，导致签名链断裂。
解决：删除错误 Profile，重新创建，关联自己生成的 kuikly 证书，绑定对应应用。
错误8：构建成功，但安装失败/闪退
原因：签名文件配置不完整、模拟器版本过低、包名冲突、资源缺失、代码异常。
解决：重启模拟器，重新构建，确认四个签名文件齐全，检查项目代码与资源，清理项目缓存。

3. 完整流程总结（超详细总结版）

整个 KuiklyUI 签名流程，一共分为五大核心步骤，一环扣一环，不可跳过、不可颠倒、不可省略、不可随意修改：
13.本地文件生成：DevEco 中生成 p12 密钥库文件与 csr 证书请求文件，路径纯英文、信息完整、密码一致、别名规范。
14.云端证书申请：AGC 平台上传 csr，生成并下载 cer 官方证书，选择发布证书，不使用调试证书。
15.应用绑定创建：AGC 平台创建应用，填写与项目完全一致的包名，生成唯一 APP ID，实现证书与应用绑定。
16.配置文件生成：AGC 平台创建 Profile，关联证书、绑定应用，下载 p7b 最终配置文件。
17.本地 IDE 配置：DevEco 中配置 p7b、p12、密码、别名，完成全量签名配置，实现项目正常构建与运行。
按照本教程的步骤，严格执行、不跳步、不瞎改、不填错、不混用文件，任何零基础新手都可以一次性完成签名配置，彻底解决鸿蒙开发中所有签名类报错、构建类报错、运行类报错，实现项目正常构建、模拟器运行、真机安装、HAP 打包全功能可用。
对于 KuiklyUI 项目来说，签名配置完成后，应用不再受限于调试模式、临时签名、自动签名，具备完整的发布级签名能力，可用于功能测试、界面演示、课程作业、项目提交、比赛展示、学习记录等所有场景，是从入门级 Demo 走向规范化、工程化、可交付项目的关键一步。
未来再遇到任何签名弹窗、红色报错、构建失败，不要慌张、不要乱填信息、不要随意删除文件，只需要按照本教程的流程，检查文件、路径、密码、别名、包名五个核心点，99% 的问题都可以快速定位、快速解决、快速恢复正常。
至此，KuiklyUI 鸿蒙应用签名全流程，从原理、操作、配置、排错、验证到总结，全部完整、详细、无跳步、无省略讲解完毕，全程可复现、可验证、可直接用于学习、笔记、长图制作、作业提交、项目交付。