景、主題、邊框字體與多語(yǔ)言)
Goldie配置詳解goldie.config.ts逐字段拆解場(chǎng)景、主題、邊框字體與多語(yǔ)言【免費(fèi)下載鏈接】goldie? agentic app store previews and screenshots項(xiàng)目地址: https://gitcode.com/gh_mirrors/gol/goldieGoldie 配置詳解Goldie 是一款面向 iOS App 的App Store 截圖與預(yù)覽視頻生成工具它的幾乎所有行為都由一個(gè)文件決定——goldie.config.ts。本文帶你逐字段讀懂這份 Goldie 配置文件從設(shè)備與多語(yǔ)言設(shè)置到主題背景、邊框bezel樣式、內(nèi)置字體再到截圖場(chǎng)景與預(yù)覽視頻的定義看完即可獨(dú)立寫(xiě)出一份完整可運(yùn)行的配置。官方提供的示例配置模板 goldie.config.example.ts 帶有很全的注釋建議對(duì)照本文一起看。一、配置文件總覽一張表看懂字段分工Goldie 配置的完整類型定義在 src/config.ts 中頂層字段只有 8 個(gè)按職責(zé)可分為四類字段作用一句話說(shuō)明appRoot/appPath/bundleId定位 App告訴 Goldie 你的工程、Release 產(chǎn)物和包名在哪里devices/locales/appearance環(huán)境與語(yǔ)言選設(shè)備尺寸、生成哪些語(yǔ)言版本、淺色還是深色模式frame/theme/store視覺(jué)設(shè)計(jì)邊框樣式、背景與字體、商店頁(yè)展示信息scenes內(nèi)容編排每張截圖、每段預(yù)覽視頻的完整定義一個(gè)容易踩坑的細(xì)節(jié)配置里所有相對(duì)路徑都以配置文件所在目錄為基準(zhǔn)解析輸出目錄out/也會(huì)創(chuàng)建在配置文件旁邊見(jiàn) loadConfig 的實(shí)現(xiàn)。想讓配置文件放在 App 倉(cāng)庫(kù)里、Goldie 從別處運(yùn)行可以設(shè)置環(huán)境變量GOLDIE_CONFIG指向它。二、設(shè)備與多語(yǔ)言devices、locales、appearance這三個(gè)字段決定了“素材要生成幾套、什么規(guī)格”。devices目前內(nèi)置的鍵來(lái)自 src/specs.ts如iphone-6.9對(duì)應(yīng) iPhone 17 Pro Max 模擬器。它會(huì)同時(shí)約束截圖尺寸1320 × 2868和預(yù)覽視頻尺寸886 × 1920這些數(shù)值都按 Apple 上傳規(guī)范寫(xiě)死在specs.ts里。locales語(yǔ)言列表例如[en-US]。配置中所有文案字段headline、subhead、商店副標(biāo)題等都是按語(yǔ)言為 key 的字典所以多語(yǔ)言支持幾乎是零成本的——多寫(xiě)一個(gè) keyout/下就會(huì)多出一個(gè)對(duì)應(yīng)語(yǔ)言目錄。appearancelight或dark統(tǒng)一控制所有截圖時(shí)模擬器的系統(tǒng)外觀。 想為日文商店生成一套素材在locales里加ja-JP然后給每條headline/subhead補(bǔ)上日語(yǔ)文案即可渲染管線會(huì)自動(dòng)為每個(gè)語(yǔ)言各輸出一遍。三、邊框frame三種內(nèi)置配色或自定義機(jī)身frame決定截圖里的 iPhone 機(jī)身外觀語(yǔ)法上只有兩種寫(xiě)法內(nèi)置變體{ variant: 17-pro-blue }。可選值定義在 FRAME_VARIANTS17-pro-silver、17-pro-blue、17-pro-orange素材就在倉(cāng)庫(kù)的assets/目錄里三種變體共用同一套屏幕開(kāi)孔幾何數(shù)據(jù)見(jiàn) src/frame.ts。自定義圖片{ image: path/to/bezel.png }一張帶透明屏幕開(kāi)孔的 PNG路徑相對(duì)配置文件。注意自定義圖意味著要重新測(cè)量幾何參數(shù)日常使用建議優(yōu)先選內(nèi)置變體。配色小技巧選與背景形成對(duì)比的機(jī)身顏色。淺藍(lán)背景配銀色機(jī)身最干凈想要更搶眼就用藍(lán)色或橙色機(jī)身。如果只想展示“裸屏”而完全不要邊框用theme.screenOnly: true即可Goldie 會(huì)給屏幕加一層柔和投影。四、主題theme背景、文字顏色與字體theme是視覺(jué)主戰(zhàn)場(chǎng)字段完整清單見(jiàn) Theme 類型定義。1. 背景background它接受任意 CSS 背景值。推薦柔和的品牌色漸變示例配置用的就是一段淺藍(lán)linear-gradient在商店縮略圖尺寸下最好看。特殊值transparent會(huì)導(dǎo)出帶透明通道的 PNG適合二次合成但不能直接上傳。2. 文字顏色headlineColor/subheadColor必須與背景保持足夠?qū)Ρ榷?。若你?Studio 里把背景改成深色Goldie 會(huì)自動(dòng)切換為淺色文字避免“黑底黑字”。3. 字體fontFamily這是一條標(biāo)準(zhǔn) CSS 字體棧。除系統(tǒng)字體外Goldie 內(nèi)置了 5 款字體文件位于assets/fonts/注冊(cè)邏輯見(jiàn) src/fonts.ts字體風(fēng)格適合場(chǎng)景Merriweather襯線雜志感、品牌敘事DM Mono等寬開(kāi)發(fā)者工具、極客風(fēng)Lato / DM Sans / Montserrat無(wú)襯線通用、現(xiàn)代、標(biāo)題感強(qiáng)只需把字體名寫(xiě)在字體棧最前面如Montserrat瀏覽器預(yù)覽和導(dǎo)出的 PNG 會(huì)保持一致的字形。4. 比例與版式copyHeightRatio文案區(qū)占截圖高度的比例示例為 0.24deviceWidthRatio機(jī)身占截圖寬度的比例示例為 0.84template/layout控制整排截圖的版式節(jié)奏下一節(jié)展開(kāi)講。五、版式節(jié)奏template與layout5 套內(nèi)置模板 11 種布局theme.template決定每張截圖依次使用哪種構(gòu)圖就像給整排截圖定一個(gè)“節(jié)拍”。完整實(shí)現(xiàn)見(jiàn) src/layouts.ts內(nèi)置模板與自定義序列的對(duì)照表整理如下模板版式序列按截圖順序循環(huán)應(yīng)用editorialpanorama → hero → offset → minimal → tiltshowcasehero → tilt → duo → tilt-right → minimalmagazineoffset → copy-below → tilt-right → hero → minimalstoryboardpanorama-duo → copy-below → hero → minimal → tiltdynamictilt → duo-tilt → panorama → minimal → tilt-right也可以直接寫(xiě)一個(gè)布局鍵數(shù)組如[panorama, hero, tilt, minimal]序列不夠長(zhǎng)會(huì)自動(dòng)循環(huán)。每張截圖還有自己的優(yōu)先級(jí)規(guī)則scenes[].layout單張覆蓋template中對(duì)應(yīng)項(xiàng) theme.layout 默認(rèn)classic11 種布局鍵中duo、duo-tilt、panorama-duo屬于“雙屏版式”需要借用下一張截圖的畫(huà)面作為第二塊屏可用secondScene指定panorama系列則橫跨 2 個(gè)商店格位。新手建議先用editorial模板起步效果均衡。六、場(chǎng)景scenes截圖場(chǎng)景與預(yù)覽場(chǎng)景scenes數(shù)組按商店頁(yè)順序排列有兩種元素。截圖場(chǎng)景kind: screenshot字段說(shuō)明id場(chǎng)景唯一標(biāo)識(shí)用于排序和覆蓋flowargent 流程名Goldie 會(huì)在其最后一步后截圖默認(rèn)從appRoot/.argent/flows查找headline/subhead按語(yǔ)言為 key 的主/副標(biāo)題文案background僅覆蓋本張的背景可選layout僅覆蓋本張的版式可選secondScene雙屏版式要借用的第二張截圖可選decorations僅本張的徽章或圖片裝飾可選文案建議官方參考 skills/goldie/references/config.md主標(biāo)題 2~5 個(gè)詞、講用戶得到的價(jià)值而非界面名稱寫(xiě) “Find anything, fast” 而不是 “Search screen”副標(biāo)題用一句話擴(kuò)展主標(biāo)題沒(méi)有把握就省略。預(yù)覽場(chǎng)景kind: previewApple 要求 App 預(yù)覽是純屏幕錄屏不能有邊框和字幕因此 Goldie 把預(yù)覽拆成若干segments每段獨(dú)立綁定一個(gè) flow、單獨(dú)錄制最后按順序拼接實(shí)現(xiàn)見(jiàn) PreviewScene 定義segments[].holdSeconds該段結(jié)束后多停留幾秒總時(shí)長(zhǎng)必須落在15~30 秒之間PREVIEW 約束可選audio字段指定背景音樂(lè)缺省時(shí)寫(xiě)入靜音音軌。分段錄制的好處是某一步流程壞了只需重錄那一段不用重錄整條“故事線”。七、商店信息store讓預(yù)覽更接近真實(shí)上架效果store字段本身不參與截圖渲染而是供 Studio 渲染一個(gè)仿真商店頁(yè)幫你判斷標(biāo)題在畫(huà)廊尺寸下是否還清晰易讀。字段包括name、subtitle按語(yǔ)言注意 Apple 的 30 字符上限、developer、category、rating、ratingCount、ageRating、price和description定義見(jiàn) StoreListing 類型。其中rating等僅起裝飾作用不影響上傳素材。八、從配置到成品輸出與校驗(yàn)配置寫(xiě)好后執(zhí)行g(shù)oldie all會(huì)完成截圖、排版、渲染與校驗(yàn)全流程產(chǎn)物落在out/下、按語(yǔ)言分目錄素材規(guī)格位置6.9 截圖1320 × 2868 PNG無(wú)透明通道out/screenshots/6.9/locale/6.9 預(yù)覽886 × 1920 H.264、30fps、15~30 秒out/previews/6.9/locale/goldie verify會(huì)用sips和ffprobe逐文件核對(duì)上述規(guī)格任何不符都會(huì)報(bào)錯(cuò)幫你避免上傳 App Store Connect 時(shí)才發(fā)現(xiàn)問(wèn)題。常見(jiàn)問(wèn)題速查改了配置沒(méi)生效確認(rèn)GOLDIE_CONFIG環(huán)境變量沒(méi)有指向舊文件且路徑相對(duì)的是配置文件目錄。報(bào) “Unknown frame variant / Unknown layout”變體與布局鍵都是封閉枚舉可用值見(jiàn) FRAME_VARIANTS 與 LAYOUT_KEYS報(bào)錯(cuò)信息會(huì)列出全部合法值。文案顏色在深色背景上看不清Studio 改背景時(shí)會(huì)自動(dòng)換淺色文字手寫(xiě)配置時(shí)請(qǐng)自行保證headlineColor與background的對(duì)比度。想換配色/排版后 CLI 輸出保持一致在 Studio 中做的修改會(huì)保存到配置文件旁的goldie.design.jsonCLI 運(yùn)行時(shí)同樣生效見(jiàn) DesignOverrides 說(shuō)明。 小結(jié)goldie.config.ts就是一個(gè)“聲明式商店素材工廠”——用devices/locales定規(guī)格frame/theme定外觀scenes定內(nèi)容。把它和 示例模板 對(duì)照填寫(xiě)配合goldie doctor自檢就能快速產(chǎn)出符合 Apple 規(guī)范的截圖與預(yù)覽視頻?！久赓M(fèi)下載鏈接】goldie? agentic app store previews and screenshots項(xiàng)目地址: https://gitcode.com/gh_mirrors/gol/goldie創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Goldie配置詳解：goldie.config.ts逐字段拆解場(chǎng)景、主題、邊框字體與多語(yǔ)言
Goldie配置詳解goldie.config.ts逐字段拆解場(chǎng)景、主題、邊框字體與多語(yǔ)言【免費(fèi)下載鏈接】goldie? agentic app store previews and screenshots項(xiàng)目地址: https://gitcode.com/gh_mirrors/gol/goldieGoldie 配置詳解Goldie 是一款面向 iOS App 的App Store 截圖與預(yù)覽視頻生成工具它的幾乎所有行為都由一個(gè)文件決定——goldie.config.ts。本文帶你逐字段讀懂這份 Goldie 配置文件從設(shè)備與多語(yǔ)言設(shè)置到主題背景、邊框bezel樣式、內(nèi)置字體再到截圖場(chǎng)景與預(yù)覽視頻的定義看完即可獨(dú)立寫(xiě)出一份完整可運(yùn)行的配置。官方提供的示例配置模板 goldie.config.example.ts 帶有很全的注釋建議對(duì)照本文一起看。一、配置文件總覽一張表看懂字段分工Goldie 配置的完整類型定義在 src/config.ts 中頂層字段只有 8 個(gè)按職責(zé)可分為四類字段作用一句話說(shuō)明appRoot/appPath/bundleId定位 App告訴 Goldie 你的工程、Release 產(chǎn)物和包名在哪里devices/locales/appearance環(huán)境與語(yǔ)言選設(shè)備尺寸、生成哪些語(yǔ)言版本、淺色還是深色模式frame/theme/store視覺(jué)設(shè)計(jì)邊框樣式、背景與字體、商店頁(yè)展示信息scenes內(nèi)容編排每張截圖、每段預(yù)覽視頻的完整定義一個(gè)容易踩坑的細(xì)節(jié)配置里所有相對(duì)路徑都以配置文件所在目錄為基準(zhǔn)解析輸出目錄out/也會(huì)創(chuàng)建在配置文件旁邊見(jiàn) loadConfig 的實(shí)現(xiàn)。想讓配置文件放在 App 倉(cāng)庫(kù)里、Goldie 從別處運(yùn)行可以設(shè)置環(huán)境變量GOLDIE_CONFIG指向它。二、設(shè)備與多語(yǔ)言devices、locales、appearance這三個(gè)字段決定了“素材要生成幾套、什么規(guī)格”。devices目前內(nèi)置的鍵來(lái)自 src/specs.ts如iphone-6.9對(duì)應(yīng) iPhone 17 Pro Max 模擬器。它會(huì)同時(shí)約束截圖尺寸1320 × 2868和預(yù)覽視頻尺寸886 × 1920這些數(shù)值都按 Apple 上傳規(guī)范寫(xiě)死在specs.ts里。locales語(yǔ)言列表例如[en-US]。配置中所有文案字段headline、subhead、商店副標(biāo)題等都是按語(yǔ)言為 key 的字典所以多語(yǔ)言支持幾乎是零成本的——多寫(xiě)一個(gè) keyout/下就會(huì)多出一個(gè)對(duì)應(yīng)語(yǔ)言目錄。appearancelight或dark統(tǒng)一控制所有截圖時(shí)模擬器的系統(tǒng)外觀。 想為日文商店生成一套素材在locales里加ja-JP然后給每條headline/subhead補(bǔ)上日語(yǔ)文案即可渲染管線會(huì)自動(dòng)為每個(gè)語(yǔ)言各輸出一遍。三、邊框frame三種內(nèi)置配色或自定義機(jī)身frame決定截圖里的 iPhone 機(jī)身外觀語(yǔ)法上只有兩種寫(xiě)法內(nèi)置變體{ variant: 17-pro-blue }。可選值定義在 FRAME_VARIANTS17-pro-silver、17-pro-blue、17-pro-orange素材就在倉(cāng)庫(kù)的assets/目錄里三種變體共用同一套屏幕開(kāi)孔幾何數(shù)據(jù)見(jiàn) src/frame.ts。自定義圖片{ image: path/to/bezel.png }一張帶透明屏幕開(kāi)孔的 PNG路徑相對(duì)配置文件。注意自定義圖意味著要重新測(cè)量幾何參數(shù)日常使用建議優(yōu)先選內(nèi)置變體。配色小技巧選與背景形成對(duì)比的機(jī)身顏色。淺藍(lán)背景配銀色機(jī)身最干凈想要更搶眼就用藍(lán)色或橙色機(jī)身。如果只想展示“裸屏”而完全不要邊框用theme.screenOnly: true即可Goldie 會(huì)給屏幕加一層柔和投影。四、主題theme背景、文字顏色與字體theme是視覺(jué)主戰(zhàn)場(chǎng)字段完整清單見(jiàn) Theme 類型定義。1. 背景background它接受任意 CSS 背景值。推薦柔和的品牌色漸變示例配置用的就是一段淺藍(lán)linear-gradient在商店縮略圖尺寸下最好看。特殊值transparent會(huì)導(dǎo)出帶透明通道的 PNG適合二次合成但不能直接上傳。2. 文字顏色headlineColor/subheadColor必須與背景保持足夠?qū)Ρ榷?。若你?Studio 里把背景改成深色Goldie 會(huì)自動(dòng)切換為淺色文字避免“黑底黑字”。3. 字體fontFamily這是一條標(biāo)準(zhǔn) CSS 字體棧。除系統(tǒng)字體外Goldie 內(nèi)置了 5 款字體文件位于assets/fonts/注冊(cè)邏輯見(jiàn) src/fonts.ts字體風(fēng)格適合場(chǎng)景Merriweather襯線雜志感、品牌敘事DM Mono等寬開(kāi)發(fā)者工具、極客風(fēng)Lato / DM Sans / Montserrat無(wú)襯線通用、現(xiàn)代、標(biāo)題感強(qiáng)只需把字體名寫(xiě)在字體棧最前面如Montserrat瀏覽器預(yù)覽和導(dǎo)出的 PNG 會(huì)保持一致的字形。4. 比例與版式copyHeightRatio文案區(qū)占截圖高度的比例示例為 0.24deviceWidthRatio機(jī)身占截圖寬度的比例示例為 0.84template/layout控制整排截圖的版式節(jié)奏下一節(jié)展開(kāi)講。五、版式節(jié)奏template與layout5 套內(nèi)置模板 11 種布局theme.template決定每張截圖依次使用哪種構(gòu)圖就像給整排截圖定一個(gè)“節(jié)拍”。完整實(shí)現(xiàn)見(jiàn) src/layouts.ts內(nèi)置模板與自定義序列的對(duì)照表整理如下模板版式序列按截圖順序循環(huán)應(yīng)用editorialpanorama → hero → offset → minimal → tiltshowcasehero → tilt → duo → tilt-right → minimalmagazineoffset → copy-below → tilt-right → hero → minimalstoryboardpanorama-duo → copy-below → hero → minimal → tiltdynamictilt → duo-tilt → panorama → minimal → tilt-right也可以直接寫(xiě)一個(gè)布局鍵數(shù)組如[panorama, hero, tilt, minimal]序列不夠長(zhǎng)會(huì)自動(dòng)循環(huán)。每張截圖還有自己的優(yōu)先級(jí)規(guī)則scenes[].layout單張覆蓋template中對(duì)應(yīng)項(xiàng) theme.layout 默認(rèn)classic11 種布局鍵中duo、duo-tilt、panorama-duo屬于“雙屏版式”需要借用下一張截圖的畫(huà)面作為第二塊屏可用secondScene指定panorama系列則橫跨 2 個(gè)商店格位。新手建議先用editorial模板起步效果均衡。六、場(chǎng)景scenes截圖場(chǎng)景與預(yù)覽場(chǎng)景scenes數(shù)組按商店頁(yè)順序排列有兩種元素。截圖場(chǎng)景kind: screenshot字段說(shuō)明id場(chǎng)景唯一標(biāo)識(shí)用于排序和覆蓋flowargent 流程名Goldie 會(huì)在其最后一步后截圖默認(rèn)從appRoot/.argent/flows查找headline/subhead按語(yǔ)言為 key 的主/副標(biāo)題文案background僅覆蓋本張的背景可選layout僅覆蓋本張的版式可選secondScene雙屏版式要借用的第二張截圖可選decorations僅本張的徽章或圖片裝飾可選文案建議官方參考 skills/goldie/references/config.md主標(biāo)題 2~5 個(gè)詞、講用戶得到的價(jià)值而非界面名稱寫(xiě) “Find anything, fast” 而不是 “Search screen”副標(biāo)題用一句話擴(kuò)展主標(biāo)題沒(méi)有把握就省略。預(yù)覽場(chǎng)景kind: previewApple 要求 App 預(yù)覽是純屏幕錄屏不能有邊框和字幕因此 Goldie 把預(yù)覽拆成若干segments每段獨(dú)立綁定一個(gè) flow、單獨(dú)錄制最后按順序拼接實(shí)現(xiàn)見(jiàn) PreviewScene 定義segments[].holdSeconds該段結(jié)束后多停留幾秒總時(shí)長(zhǎng)必須落在15~30 秒之間PREVIEW 約束可選audio字段指定背景音樂(lè)缺省時(shí)寫(xiě)入靜音音軌。分段錄制的好處是某一步流程壞了只需重錄那一段不用重錄整條“故事線”。七、商店信息store讓預(yù)覽更接近真實(shí)上架效果store字段本身不參與截圖渲染而是供 Studio 渲染一個(gè)仿真商店頁(yè)幫你判斷標(biāo)題在畫(huà)廊尺寸下是否還清晰易讀。字段包括name、subtitle按語(yǔ)言注意 Apple 的 30 字符上限、developer、category、rating、ratingCount、ageRating、price和description定義見(jiàn) StoreListing 類型。其中rating等僅起裝飾作用不影響上傳素材。八、從配置到成品輸出與校驗(yàn)配置寫(xiě)好后執(zhí)行g(shù)oldie all會(huì)完成截圖、排版、渲染與校驗(yàn)全流程產(chǎn)物落在out/下、按語(yǔ)言分目錄素材規(guī)格位置6.9 截圖1320 × 2868 PNG無(wú)透明通道out/screenshots/6.9/locale/6.9 預(yù)覽886 × 1920 H.264、30fps、15~30 秒out/previews/6.9/locale/goldie verify會(huì)用sips和ffprobe逐文件核對(duì)上述規(guī)格任何不符都會(huì)報(bào)錯(cuò)幫你避免上傳 App Store Connect 時(shí)才發(fā)現(xiàn)問(wèn)題。常見(jiàn)問(wèn)題速查改了配置沒(méi)生效確認(rèn)GOLDIE_CONFIG環(huán)境變量沒(méi)有指向舊文件且路徑相對(duì)的是配置文件目錄。報(bào) “Unknown frame variant / Unknown layout”變體與布局鍵都是封閉枚舉可用值見(jiàn) FRAME_VARIANTS 與 LAYOUT_KEYS報(bào)錯(cuò)信息會(huì)列出全部合法值。文案顏色在深色背景上看不清Studio 改背景時(shí)會(huì)自動(dòng)換淺色文字手寫(xiě)配置時(shí)請(qǐng)自行保證headlineColor與background的對(duì)比度。想換配色/排版后 CLI 輸出保持一致在 Studio 中做的修改會(huì)保存到配置文件旁的goldie.design.jsonCLI 運(yùn)行時(shí)同樣生效見(jiàn) DesignOverrides 說(shuō)明。 小結(jié)goldie.config.ts就是一個(gè)“聲明式商店素材工廠”——用devices/locales定規(guī)格frame/theme定外觀scenes定內(nèi)容。把它和 示例模板 對(duì)照填寫(xiě)配合goldie doctor自檢就能快速產(chǎn)出符合 Apple 規(guī)范的截圖與預(yù)覽視頻?！久赓M(fèi)下載鏈接】goldie? agentic app store previews and screenshots項(xiàng)目地址: https://gitcode.com/gh_mirrors/gol/goldie創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考