Android on 欧式fifty 嘅 blog

eUICC 管理详解

Sat, 20 Jun 2026 00:00:00 +0000

简介

正如我喺之前篇关于 UICC 历史嘅文章入面讲过，eUICC 系一个可编程平台。Android™ 提供咗多种方法畀用户管理 eUICC（下文称为 eSIM），包括但唔限于透过 OMAPI（Open Mobile API，需要 Android 9 / API 28 或更高版本）或者 Android Telephony API（需要 root 权限同 Android 11 或更高版本；你可以用 Magisk 取代手机上预设嘅 eSIM 管理入口）去使用 LPA（本地设定档助手）。

本文主要示范点样用 OpenEUICC 同 EasyEUICC 呢两个 app 嚟区分 OMAPI 同 Android Telephony API。呢两个 app 由 Peter Cai 开发，而且共享同一份代码库。佢哋唯一嘅区别系所用嘅管理 API（EasyEUICC 畀非特权用户，OpenEUICC 畀特权用户）。佢哋嘅分别如下表所示：

	OpenEUICC	EasyEUICC
需要特权	必须作为系统应用安装	否
内部 eSIM	支援	唔支援
外部 eSIM ¹	支援	支援
USB 读卡器	支援	支援
需要 eSIM 白名单	否	系 — USB 除外
系统整合	部分 ²	否
最低 Android 版本	Android 11 或更高	Android 9 或更高

如果你有兴趣购买兼容嘅可移动 eSIM 卡

我哋同多家优秀嘅制造商合作，为你提供一啲折扣选择。揿下面连结以更抵价购买，如果你钟意呢篇文章，都可以支持我。

eSTK.me - 省心嘅选择。支援任意 LPA app，甚至可以用任何 Android 或 iPhone 管理设定档。结账时用优惠码 OUS50 可享 9 折。
9eSIM - 经济实惠嘅选择。结账时用 OUS50 可享 9 折。

EasyEUICC - OMAPI

Note
除非你自己编译 EasyEUICC，否则你必须确保你嘅外部 eSIM 设备同 EasyEUICC 兼容，即系话设备必须符合 GSMA SGP.22 规范，而且必须支援呢个特定嘅 ARA-M SHA-1 值：2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA，跟住先可以继续操作。

下载

你可以直接喺 EasyEUICC 官方页面下载 app。

首次使用

首次启动时，EasyEUICC app 会检查你部 Android 手机对 OMAPI 嘅兼容性，并显示你可以用嚟管理兼容外部 eSIM 设备嘅 SIM 卡槽。

揿 Continue 按钮继续，你就会进入主介面：

Note
如果你只想新增/管理你嘅 eSIM 设定档，直接跳到呢度。

设定页面

揿右上角嘅 ⋮ 按钮可以睇设定：

新增 eSIM 设定档

揿右下角嘅 + 按钮，然后拣你想下载设定档去边个 eSIM 设备：

Note
你应该用 eID 而唔系 ICCID 嚟确认你嘅 eSIM。eID 系你嘅 **eSIM 设备（插入手机嘅卡）**识别号码，而 ICCID 系你嘅 eSIM 设定档识别号码。

拣你想用嘅方式（通常系用相机扫描二维码或者从相簿载入二维码）。同目标伺服器核对后，设定档下载就会开始：

Warning
下载设定档𠮶阵，请确保你有稳定可达嘅网络连接。否则你可能会永久遗失个设定档，因为设定档派发伺服器已经将你嘅设定档标记为已下载。

如果你需要用原始数据下载设定档，或者二维码用唔到

就拣最后一个选项 Enter manually。输入你嘅供应商畀你嘅对应字串：

设定档下载完成后

设定档下载完成后，你可以喺主页面查看、切换同修名个设定档：

Note
我每日都用紧 esim.gg，几年嚟喺全球旅行时佢一直都非常可靠稳定。而家数据-only eSIM 冇折扣，但如果你结账时用 ous50 买个新嘅爱沙尼亚号码，可以减 0.3 欧元。

故障排除

OMAPI 检测失败

呢种情况下，你部手机或者系统唔支援透过 OMAPI 用 EasyEUICC。考虑喺取得 root 权限后用 OpenEUICC，或者换部新啲嘅设备。

设定档下载失败

检查错误代码，试吓重新扫描二维码，或者手动下载设定档。

Warning
下载设定档𠮶阵，请确保你有稳定可达嘅网络连接。否则你可能会永久遗失个设定档，因为设定档派发伺服器已经将你嘅设定档标记为已下载。

如果你已经用晒下载次数，请联络你嘅 eSIM 设定档供应商寻求进一步协助。

揾唔到 eSIM 卡/设备

你嘅 eSIM 卡/设备可能同 EasyEUICC 唔兼容。揿呢度睇更多资讯。

常见问题

用呢个 app 会唔会被电讯商封号？

一般嚟讲唔会。但电讯商有自己嘅黑名单，某啲 eSIM 卡制造商/型号可能会被拉黑。推荐你购买上文列出嘅优质 eSIM 卡，并遵循你嘅供应商嘅指示。

我可以用呢啲卡喺其他手机上面用吗？

可以，喺你正确设定好 eSIM 卡/设备，并切换、配置好想要嘅设定档之后，你可以好似用普通实体 SIM 卡咁用呢啲卡。

你可以喺任何支援 OMAPI 嘅 Android 手机上面用 EasyEUICC app 嚟管理兼容卡上面嘅设定档。

对于 eSTK 卡，你甚至可以喺 iPhone 上面透过 STK 应用嚟管理设定档。

脚注

亦称为「可移动 eSIM」 ↩︎
电讯商合作伙伴 API 尚未实现 ↩︎

喺 WSL2 上面编译 LineageOS

Thu, 25 Jan 2024 03:46:22 +0000

安装 WSL Linux 同编译需要嘅嘢

预设会安装 Ubuntu：

# 唔显示进度条，下载快啲：
$ProgressPreference = 'SilentlyContinue'
# 用头先搵到嘅 URL，下载 appx 安装包：
Invoke-WebRequest -Uri https://aka.ms/wslubuntu -OutFile Linux.appx -UseBasicParsing

# 整返个备份同解压缩：
Copy-Item .\Linux.appx .\Linux.zip
Expand-Archive .\Linux.zip

# 搵安装程式：
Get-Childitem -Filter *.exe

# 帮 Ubuntu 装编译需要嘅嘢
sudo apt install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev libelf-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev git

如果系 Debian Bookworm 系统：

sudo apt install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git git-lfs gnupg gperf imagemagick lib32readline-dev lib32z1-dev libelf-dev liblz4-tool libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev libncurses5

安装编译工具包：

Repo

curl https://storage.googleapis.com/git-repo-downloads/repo |sudo tee /usr/bin/repo
sudo chmod a+x /usr/bin/repo

平台工具

如果你之前未装过 adb 同 fastboot，可以喺 Google 下载原版然后解压缩：

wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
wget https://dl.google.cn/android/repository/platform-tools-latest-linux.zip # 俾中国大陆嘅读者用

unzip platform-tools-latest-linux.zip -d ~/.local/bin

而家你要将 adb 同 fastboot 加到你嘅 PATH 环境变量。打开 ~/.profile 然后加下面啲嘢：

# 将 Android SDK 平台工具加到 PATH
if [ -d "$HOME/.local/bin/platform-tools" ] ; then
 PATH="$HOME/.local/bin/platform-tools:$PATH"
fi

行 source ~/.profile 嚟更新你嘅环境，或者直接重开个 shell。

Python

LineageOS 18+ 打后，编译需要 python3。

设定 Git

你要设定你嘅名同 email 嚟同步 Android 源码。

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

同步源码嗰阵可能要下载啲大文件，所以要装 git-lfs：

git lfs install

整个新资料夹嚟拉源码

mkdir lineage-21.0 && cd lineage-21.0

初始化 repo

repo init -u https://github.com/LineageOS/android.git -b lineage-21.0 # 同步成个 repo，包晒所有 commit 记录，会用好多位。
repo init -u https://github.com/LineageOS/android.git -b lineage-21.0 --depth=1 # 净系拉最新嘅 commit，冇 commit 记录，用位少好多。

开始同步 repo

repo sync -c -j$(nproc --all) --force-sync --no-clone-bundle --no-tags

跟住就跟 LineageOS 编译指南继续做……