电容资产
此工具将裁剪并调整 JPEG 和 PNG 源图像大小, 以生成 iOS 、 Android 和 进步 Web Apps 的图标和放出屏幕 电容。 。 。 .
注意: 此工具的前版本支持 Cordova, 但 Cordova 支持已被删除 1.x我们强烈推荐团队 迁移到控制器。 。 。 .
安装
npm install --save-dev @capacitor/assets
使用量
该工具预计 assets 或者说 resources 文件夹存在于工程的根中.
这个工具可以使用两种模式: Easy Mode,和 Full Control mode.
用法 - 简单模式( 建议)
使用 Easy Mode,该工具支持从一个单一的标志文件中生成所有您需要的iOS,Android,和PWA的图标和飞溅资产,以及可选的暗模式标志,和背景颜色. 这是最容易生成你所有资产的方法,但为了方便,它可以交换定制性.
要使用此模式, 请创建单个 logo.png 或者说 icon.png 带有可选 logo-dark.png 内 assets/ (该工具还支持使用 SVG 文件作为源图像, substitue) .svg 视需要:
assets/
├── logo.png
└── logo-dark.png
然后,生成资产并提供用于生成图标背景层的背景颜色:
npx @capacitor/assets generate --iconBackgroundColor '#eeeeee' --iconBackgroundColorDark '#222222' --splashBackgroundColor '#eeeeee' --splashBackgroundColorDark '#111111'
提供的旗帜是:
--iosProject- iOS 项目的路径( 默认)ios/App(中文(简体) )--androidProject- Android项目的路径(默认)android(中文(简体) )--assetPath <path>- 您项目的资产目录路径 。 默认情况下将检查"assets"财务报告和审定财务报表"resources"目录,按顺序排列.--iconBackgroundColor- 生成光模式图标层时使用的背景颜色( 小时值) (默认)#ffffff(中文(简体) )--iconBackgroundColorDark- 生成暗模式的图标层时使用的背景颜色( hex 值)(默认)#111111(中文(简体) )--splashBackgroundColor- 生成溅射屏幕时使用的背景颜色( 小时值) (默认)#ffffff(中文(简体) )--splashBackgroundColorDark- 为暗模式(在支持的情况下)生成溅射屏幕时使用的背景颜色(正值)(默认)#111111(中文(简体) )--logoSplashTargetWidth- 从一个单一的标志文件中生成溅射屏幕时设置标志的特定宽度(不是默认使用,而是以溅射的百分比来缩放标志,参见--logoSplashScale(中文(简体) )--logoSplashScale- 在从单一的标志文件中生成溅出屏幕时,适用于标志的尺度乘数(默认:0.2(中文(简体) )--ios- 明确运行iOS资产生成。 使用站台旗使站台名单独占.--android- 明确运行Android资产生成。 使用站台旗使站台名单独占.--pwa- 明确管理PWA资产产生。 使用站台旗使站台名单独占.
用法 - 自定义模式
此模式对用于生成图标和飞溅屏幕的资产提供了全面的控制,但需要更多的源文件. 要使用此模式, 请提供自定义图标和喷出屏幕源图像如下 :
assets/
├── icon-only.png
├── icon-foreground.png
├── icon-background.png
├── splash.png
└── splash-dark.png
assets/icon-only.(png|jpg)必须是至少 1024x1024pxassets/icon-(foreground|background).(png|jpg)必须是至少 1024x1024pxassets/splash[-dark].(png|jpg)必须是至少 2732x2732px
要生成所有默认选项的资源, 请运行 :
npx @capacitor/assets generate
@capacitor/assets 接受第一个参数的平台(ios, (中文(简体) ), android,或 pwa 页:1 如果指定,只为该平台产生资源:
npx @capacitor/assets generate --ios
否则 @capacitor/assets 将使用所有检测到的电容平台.
PWA 说明
声明
此工具将创建和/或更新您项目中显示的网络应用程序, 并同时支持旧的 manifest.json 文件与更新 manifest.webmanifest 文件, 偏爱 manifest.webmanifest 当找不到已有的列表时.
默认情况下,该工具将查找显示在 public, (中文(简体) ), src,以及 www 依此顺序。 使用旗帜 --pwaManifestPath 来指定您网络应用程序显示的确切路径.
帮助
参见命令行上的帮助指示 --help 旗帜.
npx @capacitor/assets generate --help