常见问题

您可能是从其他地方下载安装了 EasyEUICC 的第三方构建的版本。

请卸载后重新安装本站提供的官方版本，以确保获得最佳的用户体验和最新的功能。

此操作不会影响您的任何数据或配置文件，因为它们都存储在 eUICC 卡片上。

您当前可能是安装了 EasyEUICC 的测试版本（Debug Build），当前安装版本为稳定版本（Release Build）。

请卸载当前安装的 EasyEUICC 应用，然后重新安装稳定版本（Release Build）。

此操作不会影响您的任何数据或配置文件，因为它们都存储在 eUICC 卡片上。

这可能是因为您的 Android 设备不兼容 EasyEUICC 应用。

EasyEUICC 应用需要 Android 9（API 级别 28）或更高版本才能运行。

请确保您的设备运行的是 Android 9 或更高版本，然后重新尝试安装。

OpenEUICC 项目的代码库包含 EasyEUICC 应用的完整源代码。 ¹

OpenEUICC 的源代码发布在自托管的 Gitea 上，您可以通过此链接访问：gitea.angry.im/PeterCxy/OpenEUICC。 ²

OpenEUICC 整体采用 GPLv3 ONLY 许可证进行许可，版权声明请见 gitea.angry.im/PeterCxy/OpenEUICC#copyright。

提示

EasyEUICC 应用没有内建的自动更新功能。

请通过应用 “设置” 内的 “官方网站” 链接访问本站。 ¹

如果有新版本发布，您将看到更新提示，并可以下载最新版本。 ²

“EasyEUICC” 仅为开源软件项目名称，我们不以此名义销售任何硬件产品，也未授权任何品牌商使用该名称进行销售。

因此，市面上以 “EasyEUICC” 作为产品名称的任何产品均与我们无关。

我们目前无任何商业化计划，亦不会授权任何第三方使用 “EasyEUICC” 作为商标进行销售。 ¹

您可以参考 本站首页 的 “EasyEUICC 兼容卡片” ¹ 列表以了解更多信息。

由于受到 隐私政策 中所述的限制，我们不能收集用户设备信息以维护机型支持列表。

默认情况下，EasyEUICC 的设置选项适合大多数用户的需求。 若无特殊必要，建议保持默认值。

通知权限是可选的，但可以提升用户体验。

启用通知后，当配置文件正在下载时，EasyEUICC 可以在应用后台运行时显示进度。

但是，即使没有通知权限，EasyEUICC 在被切换到后台时仍会继续下载配置文件。

此时，Android 会显示一个默认通知，而非 EasyEUICC 的下载进度条。

目前，尚无计划将 EasyEUICC 发布至 Google Play 商店 ¹、F-Droid ² 或其他类似平台。 ³

请阅读 “如何更新 EasyEUICC 应用？” 了解如何获取最新版本的应用程序。

如果您认为 EasyEUICC 项目对您有帮助，请使用此 EASYEUICC 优惠代码购买 ESTKme 或 9eSIM 的产品，以支持我们。

我们将从他们的 Affiliate Program 中获得收益，这将帮助我们继续改进和维护 EasyEUICC 项目。

EasyEUICC 不支持 eSIM Discovery 功能，因此不能通过 eSIM Discovery 服务自动发现和下载 eSIM 配置文件。 ¹

如果您的电信运营商不提供 eSIM 二维码/激活码，则无法使用 EasyEUICC 下载 eSIM 配置文件。

注意

配置文件下载后遇到的问题与 EasyEUICC 和 eUICC 卡片无关。
通信服务是由您的电信运营商提供的，如需支持，请联系您的电信运营商。

请不要删除您已下载到 eUICC 卡片上的配置文件， 因为大多数电信运营商提供的 eSIM 二维码/激活码通常是一次有效的。

如果您删除了已下载的配置文件，很可能将无法再次使用相同的 eSIM 二维码/激活码重新下载该配置文件。

建议您联系该电信运营商，说明您的情况并请求帮助解决遇到的问题。

注意

这些问题与 EasyEUICC 和 eUICC 卡片无关，这些功能是由电信运营商提供支持的。
请联系您的电信运营商以获取更多帮助。

运营商通常会限制这些功能仅对特定设备/套餐提供支持。

请与您的运营商确认您的设备和套餐是否在其支持列表中。

一些电信运营商在下载配置文件时，可能会要求提供 “确认码”。 ¹

“确认码” 通常是一串 4 到 8 位数字，用于验证您的身份或授权下载配置文件。

如果下载过程停留在 “正在下载 eSIM 配置文件” 阶段，请填写 “确认码” 后重试下载。

EasyEUICC 目前不支持在下载过程中输入 “确认码”，请在下载前确保您已正确输入 “确认码”。

重要

请在确认如何迁移配置文件之前 不要删除已下载的配置文件， 因为大多数电信运营商提供的 eSIM 二维码/激活码通常是一次有效的。

支持 EasyEUICC 的卡片大部分为可移除卡片。此时您只需要将卡片插入新的设备。

如果确实需要将配置文件转移到新的卡片上，请与您的电信运营商联系，以了解如何获得新的 eSIM 二维码/激活码，或者是否可以使用现有的 eSIM 二维码/激活码在新的设备上重新下载配置文件。

EasyEUICC 依赖于 OMAPI ¹，但并非所有设备都支持 OMAPI；在某些多 SIM 卡设备上，仅某些卡槽支持 OMAPI。

某些设备可能缺乏必要的支持，导致无法使用 EasyEUICC。

最低 Android 版本要求为 Android 9（API 级别 28）。 ^{2 3}

注意

此问题与 EasyEUICC 无关，而是与您的设备制造商相关。

EasyEUICC 本身支持双卡甚至多卡。但是，有些设备仅在一个卡槽上提供 OMAPI 访问权限，这意味着您只能管理插入该卡槽的 EasyEUICC 兼容卡 ¹。

您可以在 “兼容性检查” 中的 “可读取的卡槽” 信息中查看，通常 SIM 0 指主卡槽，SIM 1 指副卡槽。

某些 eUICC 卡存在一个 BUG，导致某些配置文件可以覆盖卡片的 ARA-M 记录，进而使得设备无法识别该卡。

如果此操作导致 eUICC 卡无法访问，您可以使用智能卡读卡器恢复该卡。

注意

此问题与 EasyEUICC 无关，而与您的设备制造商相关。

在一些 Android 设备上，启用配置文件时可能会遇到发热和卡顿的问题。 ¹

请在执行配置文件启用操作后重启设备，以缓解此问题。

注意

禁用 / 删除当前激活的配置文件可能导致 eUICC 卡片无法识别，请谨慎操作！

一些设备无法识别没有激活的配置文件的 eUICC 卡片，因此无法管理这样的 eUICC 卡片。

为了防止这种情况发生，EasyEUICC 默认禁止直接禁用或删除当前激活的配置文件。若需要删除配置文件，请先切换到其他配置文件。

如果卡片上仅剩最后一个配置文件，默认条件下 EasyEUICC 将无法删除这个配置文件。

您可以通过 “设置” 中的 “允许 禁用/删除 已启用的配置文件” 选项来覆盖此行为。

如果因此操作导致无法识别 eUICC 卡片，您可以通过 “智能卡读卡器” 进行恢复。

某些 eUICC 卡片可能会对特定配置文件施加限制，防止其被禁用或删除。

这通常是由 eUICC 卡片制造商或电信运营商设置的限制。

在特定条件下使用 Android 系统设置禁用 eUICC 卡片后，可能会遇到无法重新启用该 eUICC 卡片的问题。 ¹

因此，请避免使用 Android 系统的设置应用对 eUICC 卡片进行任何操作。

如果已经遇到了无法重新启用的问题，请在电脑上运行以下命令，以清除 Telephony Provider 的数据： ^{2 3}

警告

请注意，执行此命令将清除所有与电话相关的数据，包括 通讯录、短信、通话记录、等。
请确保在执行此操作之前备份重要数据。

adb shell pm clear com.android.providers.telephony

配置文件的顺序无法更改，因为它们的顺序取决于 eUICC 卡片而不是 EasyEUICC。

此顺序通常是基于下载到 eUICC 卡片的顺序进行排列的。

提示

请确保您使用的是 EasyEUICC v1.5.1 或更高版本。

ESTKme Max 卡片需要使用 EasyEUICC v1.5.1 及更高版本才能正确识别 ESTKme Max 的多个 SE 并分别显示其容量信息。

注意

此问题与 EasyEUICC 无关，电信运营商会为每个配置文件分配 PIN 和 PUK 代码。

您需要联系您的电信运营商以获取 PIN 和 PUK 代码，因为这些代码是由电信运营商分配和管理的。

请注意，连续多次输入错误的 PIN 和 PUK 代码可能会导致配置文件被永久锁定，因此请谨慎操作。 ¹

如果您的配置文件已被锁定，您需要联系电信运营商使用 PUK 解锁配置文件或获取新的配置文件。

请仔细阅读

出现这个问题的原因很多。通常在该阶段，电信运营商已经允许将配置文件下载到 eUICC 卡片中，但下载过程发生了错误。
请先不要反复重试下载。电信运营商提供的 eSIM 二维码/激活码通常有尝试次数限制，频繁重试可能导致 eSIM 二维码/激活码失效。 ¹

建议按以下顺序排查：

1. 检查 eUICC 卡片是否支持电信运营商要求的特性（如 5G SUCI）。 ²
2. 确认您的设备处理器不是 MediaTek（联发科）。使用 MediaTek 处理器的设备可能存在兼容性问题，导致下载失败。 ³

这可能是您的智能卡读卡器不符合 ISO/IEC 7816 标准，请购买符合该标准的智能卡读卡器。

EasyEUICC 支持大多数严格符合 ISO/IEC 7816 标准的智能卡读卡器。

以下智能卡读卡器经过测试并与 EasyEUICC 兼容：

1. ESTKme 智能卡读卡器
2. 9eSIM 智能卡读卡器
3. Hirsch’s SCR3310 v2.0 ¹
4. Hirsch’s uTrust 2700 R / uTrust 2700 F ²
5. Hirsch’s uTrust SmartFold SCR3500 ³
6. HID OMNIKEY 3021 / OMNIKEY 3121
7. MCR3500、MCR3512、MCR3516 智能卡读卡器