2026/9/8 17:18:05
FEATURED · 精选文章 
expo/image-utils 演进全解Expo CLI 图像处理核心的版本变迁与源码剖析【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo本文以 packages/expo/image-utils/CHANGELOG.md 为主线梳理expo/image-utils这个 Expo CLI 图像处理包的完整版本演进脉络0.4.0 迁移至 expo 主仓库至当前 0.11.4并结合包内源码src/index.ts、src/sharp.ts、src/Image.ts与 package.json讲清它的 sharp/jimp 双引擎回退架构、sharp-cli全局解析机制与EXPO_IMAGE_UTILS_NO_SHARP等环境变量的实际行为帮助你在构建/导出生成图标、favicon、启动图时理解底层选型并能自行配置调优。包定位与双引擎架构expo/image-utils的自我定位在 package.json 中写得很直接A package used by Expo CLI for processing images。它是 Expo CLI 在prebuild、export、图标生成等流程中处理位图的基础设施缩放、格式转换、favicon 生成、按颜色创建纯色图等。根据 README.md 的说明包内采用双引擎策略优先使用sharpnative 图像处理库前提是能通过全局安装的sharp-cli包解析到它否则回退到jimp-compact——一个零原生依赖的纯 Node 图像库并提示用户安装sharp-cli以获得更快的图像处理速度。这一策略在 src/index.ts 中体现为统一入口imageAsync()export async function imageAsync( options: SharpGlobalOptions, commands: SharpCommandOptions[] [] ) { if (await isAvailableAsync()) { return sharpAsync(options, commands); } return jimpAsync( { ...options, format: convertFormat(options.format), originalInput: options.input }, commands ); }即先探测sharp可用性可用则走sharp-cliCLI 管线不可用则自动降级到 Jimp且对format做了适配转换convertFormat保证两条管线输出一致。版本演进CHANGELOG 逐段解读CHANGELOG.md 从 0.4.02023-12-12记录到 0.11.42026-07-22当前版本以 package.json 中的version: 0.11.4为准与 changelog 顶部Unpublished之后的最新版本一致。下面按时间倒序提炼有实际内容的版本大量中间版本标注为This version does not introduce any user-facing changes多为依赖同步/发版节奏产物此处从略。0.10.0 — 2026-05-20升级 expo/spawn-asyncBump toexpo/spawn-async^1.8.0。这一点可以与 package.json 交叉印证当前依赖正是expo/spawn-async: ^1.8.0。该库用于 src/sharp.ts 中spawnAsync(bin, [...])调用sharp二进制执行图像管线升级属于子进程执行层的依赖维护。0.8.13 — 2026-04-09改用 expo/require-utils 解析 sharpUseexpo/require-utilsfor sharp resolution。对应源码 src/sharp.ts 首行import { resolveFrom, resolveGlobal } from expo/require-utils以及 package.json 中的expo/require-utils: workspace:^56.1.3依赖。这个变更把sharp-cli/sharp的模块定位逻辑收敛到了仓库内统一的工具包是0.8.11 改进 sharp-cli 全局解析之后的又一次加固。0.8.11 — 2026-01-26瘦身与解析改进Dropunique-string与temp-dir依赖Improve global resolution forsharp-cliresolution。对照 package.json 的依赖列表可以确认unique-string、temp-dir均已不在依赖中仅保留expo/require-utils、expo/spawn-async、chalk、getenv、jimp-compact、parse-png、semver七项运行时依赖。解析改进则体现在 src/sharp.ts 的findSharpBinAsync()中先resolveGlobal、再require.resolve、最后回退 PATH 上的sharp命令的多级解析链下文详述。0.8.0 — 2025-08-13支持 P3 色彩的 sharp 升级Update tosharp-cli5.2.0to support P3 colors insharp0.34.2。这解释了 package.json devDependencies 中sharp: ~0.34.2、sharp-cli: ^5.2.0的取值来源也解释了 src/sharp.ts 中的版本门槛常量const SHARP_REQUIRED_VERSION ^5.2.0;即 0.8.0 起包要求全局sharp-cli满足^5.2.0P3 广色域支持是 Apple 平台图标质量的关键0.6.0 新增的 dark/tinted 图标变体生成正是这一演进链条的一环。0.7.x环境读取与依赖替换0.7.52025-07-01Update togetenv2.0.0to support upper case boolean environment variables。getenv在本包 src/env.ts 中被用来读取EXPO_IMAGE_UTILS_NO_SHARP、EXPO_IMAGE_UTILS_DEBUG等全大写变量2.0.0 起支持大写布尔环境变量的正确解析。0.7.02025-04-04Dropfs-extrain favor offs。依赖替换后src/Image.ts 等文件直接import fs from fs运行时依赖进一步收窄。0.6.0 — 2024-10-22Apple 平台深色/着色图标变体Properly support dark/tinted icon variant generation on Apple platformsDropnode-fetchin favor of Node built-infetchfor Node 22 supportDroptempyin favor of equivalent code to avoid transitive, deprecatedrimrafdependency。这是该包一个功能性的里程碑版本Expo 从 0.6.0 起能正确生成 Apple 平台要求的深色模式dark与着色tinted图标变体。后两条则是典型的去重依赖动作——换用 Node 22 内置fetch与内联临时目录逻辑package.json 中确实不再出现node-fetch与tempy。0.5.0 — 2024-04-18createSquareAsync 公开ExposecreateSquareAsyncto generate a square image from a colorFixed vulnerability with update semver from 7.5.3 to 7.5.4。从 src/index.ts 可见createSquareAsync经由export { jimpAsync, createSquareAsync, ... }成为公开 API 的一部分。它的用途在 src/Image.ts 中可直接看到generateImageBackgroundAsync()在 Jimp 路径下调用Jimp.createSquareAsync({ size: width, color: backgroundColor })生成纯色方图作为图标/启动图背景。当前 package.json 中semver: ^7.6.0也说明 semver 漏洞修复后还经历了常规小版本推进。0.4.x仓库迁移与清理0.4.02023-12-12Move package fromexpo/expo-clitoexpo/expo。即该包从独立维护的 expo-cli 仓库迁移进当前这个 Expo 主 monorepopackage.json 中repository.directory指向packages/expo/image-utils即此迁移后的产物0.4.12023-12-19RemovemimepackageMIME 判断逻辑内联到 src/Image.ts 的getMimeType()中png/jpg/webp/gif扩展名到 MIME 的映射表。源码剖析sharp-cli 的三级解析与降级机制CHANGELOG 中 0.8.11、0.8.13 两条resolution相关变更落到 src/sharp.ts 就是findSharpBinAsync()这条解析链全局包优先resolveGlobal(sharp-cli/package.json)找到全局安装的sharp-cli本地兜底全局找不到时退而require.resolve(sharp-cli/package.json)并用resolveFrom(sharpCliPackagePath, sharp)从该位置解析出sharp模块本体版本校验semver.satisfies(sharpCliPackage.version, SHARP_REQUIRED_VERSION)校验sharp-cli版本必须满足^5.2.0且要求sharp实例能读出versions.vipsPATH 回退上述均失败时直接spawnAsync(sharp, [--version])探测 PATH 上是否有sharp命令版本不满足时打印一次性黄色警告提示npm install -g sharp-cli^5.2.0或用EXPO_IMAGE_UTILS_NO_SHARP1禁用。if ( sharpCliPackagePath semver.satisfies(sharpCliPackage.version, SHARP_REQUIRED_VERSION) typeof sharpCliPackage.bin.sharp string typeof _sharpInstance?.versions?.vips string ) { _sharpBin path.join(path.dirname(sharpCliPackagePath), sharpCliPackage.bin.sharp); _sharpInstance sharpInstance; return _sharpBin; }注意isAvailableAsync()的判定标准是CLI 与模块都找到才算可用return !!_sharpBin !!_sharpInstance而findSharpInstanceAsync()在环境被禁用时会主动抛错——README 特别说明了这一点findSharpInstanceAsync()不应在isAvailableAsync()返回false时调用。环境变量配置环境变量取值作用源码位置EXPO_IMAGE_UTILS_NO_SHARPtruthy如1强制禁用全局sharp-cli解析isAvailableAsync()直接返回false整体回退到 Jimp 管线src/sharp.ts 的isAvailableAsync()/findSharpInstanceAsync()EXPO_IMAGE_UTILS_DEBUGtruthy打开调试输出sharp 加载失败时打印原因未安装 sharp 时提示Using node to generate images. This is much slower...src/Image.ts 的maybeWarnAboutInstallingSharpAsync()这两个变量通过 src/env.ts 以getenv读取——0.7.5 升级到getenv2.0.0正是为了保证这类全大写布尔变量被正确解析。图像处理 API从 CHANGELOG 特性到可调用接口结合 changelog 中 0.5.0 的createSquareAsync与 src/index.ts 的导出表当前对外能力包括imageAsync(options, commands)双引擎统一入口sharp 优先、jimp 回退generateImageAsync()生成指定尺寸的图标/启动图支持resizeMode默认contain、backgroundColor、borderRadiusJimp 路径下圆形兜底、sharp 路径下 SVG 蒙版圆角、removeTransparency等选项见 src/Image.ts 的resizeAsync()generateFaviconAsync()多尺寸 favicon 生成Expo CLI 的 export 流程packages/expo/cli/src/export/favicon.ts通过compositeImagesAsync等函数消费本包能力generateImageBackgroundAsync()从纯色创建背景图createSquareAsync()0.5.0 起公开的纯色方图生成jimpAsync()/sharpAsync()两条管线的直接入口Cache图像处理缓存避免重复缩放相同资源。命令层参数类型定义在 src/sharp.types.tsSharpGlobalOptionsinput、output、format、quality、progressive、limitInputPixels等与SharpCommandOptionsresize/flatten/removeAlpha三类操作。src/sharp.ts 的getOptions()/getCommandOptions()负责把这些结构体翻译成sharp-cli的命令行参数布尔变 flag、数字toFixed()、命令间以--分隔因此该包同时驱动 sharp 的进程内 APIresizeBufferAsync用与CLI 管线sharpAsync用两种形态。依赖变更与 changelog 的对照验证把 changelog 中的依赖动作与 package.json 当前状态对照可以完整复核每一次瘦身changelog 条目版本当前依赖状态Dropunique-string、temp-dir0.8.11不在依赖列表Useexpo/require-utilsfor sharp resolution0.8.13expo/require-utils: workspace:^56.1.3Bumpexpo/spawn-async^1.8.00.10.0expo/spawn-async: ^1.8.0Update togetenv2.0.00.7.5getenv: ^2.0.0Dropfs-extrain favor offs0.7.0使用 Node 内置fsDropnode-fetch/tempy0.6.0不在依赖列表semver 安全修复7.5.3 → 7.5.40.5.0semver: ^7.6.0后续常规推进Removemime0.4.1不在依赖列表逻辑内联至 src/Image.ts最终运行时依赖仅 7 项expo/require-utils、expo/spawn-async、chalk、getenv、jimp-compact0.16.1、parse-png、semver而sharp与sharp-cli只作为 devDependencies 存在于开发/测试环境e2e/tests/sharp-test.ts生产环境依赖用户全局安装sharp-cli——这与零强制原生依赖的包设计取向一致。小结从 CHANGELOG.md 的完整记录看expo/image-utils的演进主线有两条一条是功能线0.5.0createSquareAsync公开 → 0.6.0 Apple 深色/着色图标变体 → 0.8.0 P3 广色域另一条是工程线持续移除fs-extra、node-fetch、tempy、unique-string、temp-dir、mime等依赖将模块解析收敛到expo/require-utils。两条线共同塑造了当前形态一个以sharp-cli全局解析为高性能路径、以 Jimp 为无依赖兜底路径的图像处理基座配合EXPO_IMAGE_UTILS_NO_SHARP/EXPO_IMAGE_UTILS_DEBUG两个环境变量即可在 CI 或受限环境中完成降级与诊断。【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
@expo/image-utils 演进全解：Expo CLI 图像处理核心的版本变迁与源码剖析
expo/image-utils 演进全解Expo CLI 图像处理核心的版本变迁与源码剖析【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo本文以 packages/expo/image-utils/CHANGELOG.md 为主线梳理expo/image-utils这个 Expo CLI 图像处理包的完整版本演进脉络0.4.0 迁移至 expo 主仓库至当前 0.11.4并结合包内源码src/index.ts、src/sharp.ts、src/Image.ts与 package.json讲清它的 sharp/jimp 双引擎回退架构、sharp-cli全局解析机制与EXPO_IMAGE_UTILS_NO_SHARP等环境变量的实际行为帮助你在构建/导出生成图标、favicon、启动图时理解底层选型并能自行配置调优。包定位与双引擎架构expo/image-utils的自我定位在 package.json 中写得很直接A package used by Expo CLI for processing images。它是 Expo CLI 在prebuild、export、图标生成等流程中处理位图的基础设施缩放、格式转换、favicon 生成、按颜色创建纯色图等。根据 README.md 的说明包内采用双引擎策略优先使用sharpnative 图像处理库前提是能通过全局安装的sharp-cli包解析到它否则回退到jimp-compact——一个零原生依赖的纯 Node 图像库并提示用户安装sharp-cli以获得更快的图像处理速度。这一策略在 src/index.ts 中体现为统一入口imageAsync()export async function imageAsync( options: SharpGlobalOptions, commands: SharpCommandOptions[] [] ) { if (await isAvailableAsync()) { return sharpAsync(options, commands); } return jimpAsync( { ...options, format: convertFormat(options.format), originalInput: options.input }, commands ); }即先探测sharp可用性可用则走sharp-cliCLI 管线不可用则自动降级到 Jimp且对format做了适配转换convertFormat保证两条管线输出一致。版本演进CHANGELOG 逐段解读CHANGELOG.md 从 0.4.02023-12-12记录到 0.11.42026-07-22当前版本以 package.json 中的version: 0.11.4为准与 changelog 顶部Unpublished之后的最新版本一致。下面按时间倒序提炼有实际内容的版本大量中间版本标注为This version does not introduce any user-facing changes多为依赖同步/发版节奏产物此处从略。0.10.0 — 2026-05-20升级 expo/spawn-asyncBump toexpo/spawn-async^1.8.0。这一点可以与 package.json 交叉印证当前依赖正是expo/spawn-async: ^1.8.0。该库用于 src/sharp.ts 中spawnAsync(bin, [...])调用sharp二进制执行图像管线升级属于子进程执行层的依赖维护。0.8.13 — 2026-04-09改用 expo/require-utils 解析 sharpUseexpo/require-utilsfor sharp resolution。对应源码 src/sharp.ts 首行import { resolveFrom, resolveGlobal } from expo/require-utils以及 package.json 中的expo/require-utils: workspace:^56.1.3依赖。这个变更把sharp-cli/sharp的模块定位逻辑收敛到了仓库内统一的工具包是0.8.11 改进 sharp-cli 全局解析之后的又一次加固。0.8.11 — 2026-01-26瘦身与解析改进Dropunique-string与temp-dir依赖Improve global resolution forsharp-cliresolution。对照 package.json 的依赖列表可以确认unique-string、temp-dir均已不在依赖中仅保留expo/require-utils、expo/spawn-async、chalk、getenv、jimp-compact、parse-png、semver七项运行时依赖。解析改进则体现在 src/sharp.ts 的findSharpBinAsync()中先resolveGlobal、再require.resolve、最后回退 PATH 上的sharp命令的多级解析链下文详述。0.8.0 — 2025-08-13支持 P3 色彩的 sharp 升级Update tosharp-cli5.2.0to support P3 colors insharp0.34.2。这解释了 package.json devDependencies 中sharp: ~0.34.2、sharp-cli: ^5.2.0的取值来源也解释了 src/sharp.ts 中的版本门槛常量const SHARP_REQUIRED_VERSION ^5.2.0;即 0.8.0 起包要求全局sharp-cli满足^5.2.0P3 广色域支持是 Apple 平台图标质量的关键0.6.0 新增的 dark/tinted 图标变体生成正是这一演进链条的一环。0.7.x环境读取与依赖替换0.7.52025-07-01Update togetenv2.0.0to support upper case boolean environment variables。getenv在本包 src/env.ts 中被用来读取EXPO_IMAGE_UTILS_NO_SHARP、EXPO_IMAGE_UTILS_DEBUG等全大写变量2.0.0 起支持大写布尔环境变量的正确解析。0.7.02025-04-04Dropfs-extrain favor offs。依赖替换后src/Image.ts 等文件直接import fs from fs运行时依赖进一步收窄。0.6.0 — 2024-10-22Apple 平台深色/着色图标变体Properly support dark/tinted icon variant generation on Apple platformsDropnode-fetchin favor of Node built-infetchfor Node 22 supportDroptempyin favor of equivalent code to avoid transitive, deprecatedrimrafdependency。这是该包一个功能性的里程碑版本Expo 从 0.6.0 起能正确生成 Apple 平台要求的深色模式dark与着色tinted图标变体。后两条则是典型的去重依赖动作——换用 Node 22 内置fetch与内联临时目录逻辑package.json 中确实不再出现node-fetch与tempy。0.5.0 — 2024-04-18createSquareAsync 公开ExposecreateSquareAsyncto generate a square image from a colorFixed vulnerability with update semver from 7.5.3 to 7.5.4。从 src/index.ts 可见createSquareAsync经由export { jimpAsync, createSquareAsync, ... }成为公开 API 的一部分。它的用途在 src/Image.ts 中可直接看到generateImageBackgroundAsync()在 Jimp 路径下调用Jimp.createSquareAsync({ size: width, color: backgroundColor })生成纯色方图作为图标/启动图背景。当前 package.json 中semver: ^7.6.0也说明 semver 漏洞修复后还经历了常规小版本推进。0.4.x仓库迁移与清理0.4.02023-12-12Move package fromexpo/expo-clitoexpo/expo。即该包从独立维护的 expo-cli 仓库迁移进当前这个 Expo 主 monorepopackage.json 中repository.directory指向packages/expo/image-utils即此迁移后的产物0.4.12023-12-19RemovemimepackageMIME 判断逻辑内联到 src/Image.ts 的getMimeType()中png/jpg/webp/gif扩展名到 MIME 的映射表。源码剖析sharp-cli 的三级解析与降级机制CHANGELOG 中 0.8.11、0.8.13 两条resolution相关变更落到 src/sharp.ts 就是findSharpBinAsync()这条解析链全局包优先resolveGlobal(sharp-cli/package.json)找到全局安装的sharp-cli本地兜底全局找不到时退而require.resolve(sharp-cli/package.json)并用resolveFrom(sharpCliPackagePath, sharp)从该位置解析出sharp模块本体版本校验semver.satisfies(sharpCliPackage.version, SHARP_REQUIRED_VERSION)校验sharp-cli版本必须满足^5.2.0且要求sharp实例能读出versions.vipsPATH 回退上述均失败时直接spawnAsync(sharp, [--version])探测 PATH 上是否有sharp命令版本不满足时打印一次性黄色警告提示npm install -g sharp-cli^5.2.0或用EXPO_IMAGE_UTILS_NO_SHARP1禁用。if ( sharpCliPackagePath semver.satisfies(sharpCliPackage.version, SHARP_REQUIRED_VERSION) typeof sharpCliPackage.bin.sharp string typeof _sharpInstance?.versions?.vips string ) { _sharpBin path.join(path.dirname(sharpCliPackagePath), sharpCliPackage.bin.sharp); _sharpInstance sharpInstance; return _sharpBin; }注意isAvailableAsync()的判定标准是CLI 与模块都找到才算可用return !!_sharpBin !!_sharpInstance而findSharpInstanceAsync()在环境被禁用时会主动抛错——README 特别说明了这一点findSharpInstanceAsync()不应在isAvailableAsync()返回false时调用。环境变量配置环境变量取值作用源码位置EXPO_IMAGE_UTILS_NO_SHARPtruthy如1强制禁用全局sharp-cli解析isAvailableAsync()直接返回false整体回退到 Jimp 管线src/sharp.ts 的isAvailableAsync()/findSharpInstanceAsync()EXPO_IMAGE_UTILS_DEBUGtruthy打开调试输出sharp 加载失败时打印原因未安装 sharp 时提示Using node to generate images. This is much slower...src/Image.ts 的maybeWarnAboutInstallingSharpAsync()这两个变量通过 src/env.ts 以getenv读取——0.7.5 升级到getenv2.0.0正是为了保证这类全大写布尔变量被正确解析。图像处理 API从 CHANGELOG 特性到可调用接口结合 changelog 中 0.5.0 的createSquareAsync与 src/index.ts 的导出表当前对外能力包括imageAsync(options, commands)双引擎统一入口sharp 优先、jimp 回退generateImageAsync()生成指定尺寸的图标/启动图支持resizeMode默认contain、backgroundColor、borderRadiusJimp 路径下圆形兜底、sharp 路径下 SVG 蒙版圆角、removeTransparency等选项见 src/Image.ts 的resizeAsync()generateFaviconAsync()多尺寸 favicon 生成Expo CLI 的 export 流程packages/expo/cli/src/export/favicon.ts通过compositeImagesAsync等函数消费本包能力generateImageBackgroundAsync()从纯色创建背景图createSquareAsync()0.5.0 起公开的纯色方图生成jimpAsync()/sharpAsync()两条管线的直接入口Cache图像处理缓存避免重复缩放相同资源。命令层参数类型定义在 src/sharp.types.tsSharpGlobalOptionsinput、output、format、quality、progressive、limitInputPixels等与SharpCommandOptionsresize/flatten/removeAlpha三类操作。src/sharp.ts 的getOptions()/getCommandOptions()负责把这些结构体翻译成sharp-cli的命令行参数布尔变 flag、数字toFixed()、命令间以--分隔因此该包同时驱动 sharp 的进程内 APIresizeBufferAsync用与CLI 管线sharpAsync用两种形态。依赖变更与 changelog 的对照验证把 changelog 中的依赖动作与 package.json 当前状态对照可以完整复核每一次瘦身changelog 条目版本当前依赖状态Dropunique-string、temp-dir0.8.11不在依赖列表Useexpo/require-utilsfor sharp resolution0.8.13expo/require-utils: workspace:^56.1.3Bumpexpo/spawn-async^1.8.00.10.0expo/spawn-async: ^1.8.0Update togetenv2.0.00.7.5getenv: ^2.0.0Dropfs-extrain favor offs0.7.0使用 Node 内置fsDropnode-fetch/tempy0.6.0不在依赖列表semver 安全修复7.5.3 → 7.5.40.5.0semver: ^7.6.0后续常规推进Removemime0.4.1不在依赖列表逻辑内联至 src/Image.ts最终运行时依赖仅 7 项expo/require-utils、expo/spawn-async、chalk、getenv、jimp-compact0.16.1、parse-png、semver而sharp与sharp-cli只作为 devDependencies 存在于开发/测试环境e2e/tests/sharp-test.ts生产环境依赖用户全局安装sharp-cli——这与零强制原生依赖的包设计取向一致。小结从 CHANGELOG.md 的完整记录看expo/image-utils的演进主线有两条一条是功能线0.5.0createSquareAsync公开 → 0.6.0 Apple 深色/着色图标变体 → 0.8.0 P3 广色域另一条是工程线持续移除fs-extra、node-fetch、tempy、unique-string、temp-dir、mime等依赖将模块解析收敛到expo/require-utils。两条线共同塑造了当前形态一个以sharp-cli全局解析为高性能路径、以 Jimp 为无依赖兜底路径的图像处理基座配合EXPO_IMAGE_UTILS_NO_SHARP/EXPO_IMAGE_UTILS_DEBUG两个环境变量即可在 CI 或受限环境中完成降级与诊断。【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
