[{"data":1,"prerenderedAt":901},["ShallowReactive",2],{"content:\u002Funh\u002Fhooks":3,"section:unh":880},{"id":4,"title":5,"aside":6,"authors":7,"badges":8,"banner":7,"body":17,"breadcrumb":6,"collapse":871,"description":872,"editLink":6,"extension":873,"fullpage":871,"header":7,"icon":874,"main":7,"meta":875,"navBadges":7,"navTruncate":871,"navigation":7,"path":876,"prevNext":6,"seo":877,"stem":878,"toc":6,"__hash__":879},"content\u002Funh\u002F3.hooks.md","自定义Hooks",true,null,[9,13],{"value":10,"to":11,"target":12},"npm","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@uni-helper\u002Funh","_blank",{"value":14,"icon":15,"to":16,"target":12},"source","lucide:code","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Funh",{"type":18,"value":19,"toc":865},"minimark",[20,33,37,447,450,540,543,574,666,677,680,683,850,861],[21,22,23,24,28,29,32],"p",{},"hooks 让它在 ",[25,26,27],"code",{},"dev","、",[25,30,31],{},"build"," 前后执行自定义逻辑。",[34,35,36],"h2",{"id":36},"配置",[38,39,45],"pre",{"className":40,"code":41,"filename":42,"language":43,"meta":44,"style":44},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineConfig } from '@uni-helper\u002Funh'\n\nexport default defineConfig({\n  hooks: {\n    \u002F\u002F prepare 阶段执行\n    prepare() {\n      console.log('prepare')\n    },\n    \u002F\u002F 开发前执行\n    dev({ platform, options, envData }) {\n      console.log('dev:', platform, options, envData)\n    },\n    \u002F\u002F 开发后执行，只会执行一次\n    onDevAfter({ platform, options, envData }) {\n      console.log('devAfter:', platform, options, envData)\n    },\n    \u002F\u002F 构建前执行\n    build({ platform, options, envData }) {\n      console.log('build:', platform, options, envData)\n    },\n    \u002F\u002F 构建后执行\n    onBuildAfter({ platform, options, envData }) {\n      console.log('buildAfter:', platform, options, envData)\n    },\n  },\n})\n","unh.config.ts","ts","",[25,46,47,80,86,104,117,124,135,160,166,172,201,233,238,244,266,298,303,309,331,363,368,374,396,428,433,439],{"__ignoreMap":44},[48,49,52,56,60,64,67,70,73,77],"span",{"class":50,"line":51},"line",1,[48,53,55],{"class":54},"s7zQu","import",[48,57,59],{"class":58},"sMK4o"," {",[48,61,63],{"class":62},"sTEyZ"," defineConfig",[48,65,66],{"class":58}," }",[48,68,69],{"class":54}," from",[48,71,72],{"class":58}," '",[48,74,76],{"class":75},"sfazB","@uni-helper\u002Funh",[48,78,79],{"class":58},"'\n",[48,81,83],{"class":50,"line":82},2,[48,84,85],{"emptyLinePlaceholder":6},"\n",[48,87,89,92,95,98,101],{"class":50,"line":88},3,[48,90,91],{"class":54},"export",[48,93,94],{"class":54}," default",[48,96,63],{"class":97},"s2Zo4",[48,99,100],{"class":62},"(",[48,102,103],{"class":58},"{\n",[48,105,107,111,114],{"class":50,"line":106},4,[48,108,110],{"class":109},"swJcz","  hooks",[48,112,113],{"class":58},":",[48,115,116],{"class":58}," {\n",[48,118,120],{"class":50,"line":119},5,[48,121,123],{"class":122},"sHwdD","    \u002F\u002F prepare 阶段执行\n",[48,125,127,130,133],{"class":50,"line":126},6,[48,128,129],{"class":109},"    prepare",[48,131,132],{"class":58},"()",[48,134,116],{"class":58},[48,136,138,141,144,147,149,152,155,157],{"class":50,"line":137},7,[48,139,140],{"class":62},"      console",[48,142,143],{"class":58},".",[48,145,146],{"class":97},"log",[48,148,100],{"class":109},[48,150,151],{"class":58},"'",[48,153,154],{"class":75},"prepare",[48,156,151],{"class":58},[48,158,159],{"class":109},")\n",[48,161,163],{"class":50,"line":162},8,[48,164,165],{"class":58},"    },\n",[48,167,169],{"class":50,"line":168},9,[48,170,171],{"class":122},"    \u002F\u002F 开发前执行\n",[48,173,175,178,181,185,188,191,193,196,199],{"class":50,"line":174},10,[48,176,177],{"class":109},"    dev",[48,179,180],{"class":58},"({",[48,182,184],{"class":183},"sHdIc"," platform",[48,186,187],{"class":58},",",[48,189,190],{"class":183}," options",[48,192,187],{"class":58},[48,194,195],{"class":183}," envData",[48,197,198],{"class":58}," })",[48,200,116],{"class":58},[48,202,204,206,208,210,212,214,217,219,221,223,225,227,229,231],{"class":50,"line":203},11,[48,205,140],{"class":62},[48,207,143],{"class":58},[48,209,146],{"class":97},[48,211,100],{"class":109},[48,213,151],{"class":58},[48,215,216],{"class":75},"dev:",[48,218,151],{"class":58},[48,220,187],{"class":58},[48,222,184],{"class":62},[48,224,187],{"class":58},[48,226,190],{"class":62},[48,228,187],{"class":58},[48,230,195],{"class":62},[48,232,159],{"class":109},[48,234,236],{"class":50,"line":235},12,[48,237,165],{"class":58},[48,239,241],{"class":50,"line":240},13,[48,242,243],{"class":122},"    \u002F\u002F 开发后执行，只会执行一次\n",[48,245,247,250,252,254,256,258,260,262,264],{"class":50,"line":246},14,[48,248,249],{"class":109},"    onDevAfter",[48,251,180],{"class":58},[48,253,184],{"class":183},[48,255,187],{"class":58},[48,257,190],{"class":183},[48,259,187],{"class":58},[48,261,195],{"class":183},[48,263,198],{"class":58},[48,265,116],{"class":58},[48,267,269,271,273,275,277,279,282,284,286,288,290,292,294,296],{"class":50,"line":268},15,[48,270,140],{"class":62},[48,272,143],{"class":58},[48,274,146],{"class":97},[48,276,100],{"class":109},[48,278,151],{"class":58},[48,280,281],{"class":75},"devAfter:",[48,283,151],{"class":58},[48,285,187],{"class":58},[48,287,184],{"class":62},[48,289,187],{"class":58},[48,291,190],{"class":62},[48,293,187],{"class":58},[48,295,195],{"class":62},[48,297,159],{"class":109},[48,299,301],{"class":50,"line":300},16,[48,302,165],{"class":58},[48,304,306],{"class":50,"line":305},17,[48,307,308],{"class":122},"    \u002F\u002F 构建前执行\n",[48,310,312,315,317,319,321,323,325,327,329],{"class":50,"line":311},18,[48,313,314],{"class":109},"    build",[48,316,180],{"class":58},[48,318,184],{"class":183},[48,320,187],{"class":58},[48,322,190],{"class":183},[48,324,187],{"class":58},[48,326,195],{"class":183},[48,328,198],{"class":58},[48,330,116],{"class":58},[48,332,334,336,338,340,342,344,347,349,351,353,355,357,359,361],{"class":50,"line":333},19,[48,335,140],{"class":62},[48,337,143],{"class":58},[48,339,146],{"class":97},[48,341,100],{"class":109},[48,343,151],{"class":58},[48,345,346],{"class":75},"build:",[48,348,151],{"class":58},[48,350,187],{"class":58},[48,352,184],{"class":62},[48,354,187],{"class":58},[48,356,190],{"class":62},[48,358,187],{"class":58},[48,360,195],{"class":62},[48,362,159],{"class":109},[48,364,366],{"class":50,"line":365},20,[48,367,165],{"class":58},[48,369,371],{"class":50,"line":370},21,[48,372,373],{"class":122},"    \u002F\u002F 构建后执行\n",[48,375,377,380,382,384,386,388,390,392,394],{"class":50,"line":376},22,[48,378,379],{"class":109},"    onBuildAfter",[48,381,180],{"class":58},[48,383,184],{"class":183},[48,385,187],{"class":58},[48,387,190],{"class":183},[48,389,187],{"class":58},[48,391,195],{"class":183},[48,393,198],{"class":58},[48,395,116],{"class":58},[48,397,399,401,403,405,407,409,412,414,416,418,420,422,424,426],{"class":50,"line":398},23,[48,400,140],{"class":62},[48,402,143],{"class":58},[48,404,146],{"class":97},[48,406,100],{"class":109},[48,408,151],{"class":58},[48,410,411],{"class":75},"buildAfter:",[48,413,151],{"class":58},[48,415,187],{"class":58},[48,417,184],{"class":62},[48,419,187],{"class":58},[48,421,190],{"class":62},[48,423,187],{"class":58},[48,425,195],{"class":62},[48,427,159],{"class":109},[48,429,431],{"class":50,"line":430},24,[48,432,165],{"class":58},[48,434,436],{"class":50,"line":435},25,[48,437,438],{"class":58},"  },\n",[48,440,442,445],{"class":50,"line":441},26,[48,443,444],{"class":58},"}",[48,446,159],{"class":62},[34,448,449],{"id":449},"执行时机",[451,452,453,465],"table",{},[454,455,456],"thead",{},[457,458,459,463],"tr",{},[460,461,462],"th",{},"hook",[460,464,449],{},[466,467,468,488,501,517,528],"tbody",{},[457,469,470,475],{},[471,472,473],"td",{},[25,474,154],{},[471,476,477,480,481,484,485,487],{},[25,478,479],{},"unh prepare"," 调用时，也适合放进 ",[25,482,483],{},"package.json"," 的 ",[25,486,154],{}," 脚本",[457,489,490,494],{},[471,491,492],{},[25,493,27],{},[471,495,496,497,500],{},"执行 ",[25,498,499],{},"uni dev"," 之前",[457,502,503,508],{},[471,504,505],{},[25,506,507],{},"onDevAfter",[471,509,510,512,513,516],{},[25,511,499],{}," 输出 ",[25,514,515],{},"ready in"," 之后，只执行一次",[457,518,519,523],{},[471,520,521],{},[25,522,31],{},[471,524,496,525,500],{},[25,526,527],{},"uni build",[457,529,530,535],{},[471,531,532],{},[25,533,534],{},"onBuildAfter",[471,536,537,539],{},[25,538,527],{}," 结束之后",[34,541,542],{"id":542},"参数",[544,545,546,553,559,564,569],"field-group",{},[547,548,550],"field",{"name":154,"type":549},"() => void | Promise\u003Cvoid>",[21,551,552],{},"不接收参数",[547,554,556],{"name":27,"type":555},"(options: HookOptions) => void | Promise\u003Cvoid>",[21,557,558],{},"开发前执行",[547,560,561],{"name":507,"type":555},[21,562,563],{},"开发后执行，只会执行一次",[547,565,566],{"name":31,"type":555},[21,567,568],{},"构建前执行",[547,570,571],{"name":534,"type":555},[21,572,573],{},"构建后执行",[38,575,577],{"className":40,"code":576,"language":43,"meta":44,"style":44},"interface HookOptions {\n  \u002F** 当前编译平台 *\u002F\n  platform?: Platform\n  \u002F** 编译命令行参数 *\u002F\n  options?: Record\u003Cstring, any>\n  \u002F** 当前编译环境变量，需要开启 env 配置才有该数据 *\u002F\n  envData?: Record\u003Cstring, string>\n}\n",[25,578,579,591,596,607,612,636,641,661],{"__ignoreMap":44},[48,580,581,585,589],{"class":50,"line":51},[48,582,584],{"class":583},"spNyl","interface",[48,586,588],{"class":587},"sBMFI"," HookOptions",[48,590,116],{"class":58},[48,592,593],{"class":50,"line":82},[48,594,595],{"class":122},"  \u002F** 当前编译平台 *\u002F\n",[48,597,598,601,604],{"class":50,"line":88},[48,599,600],{"class":109},"  platform",[48,602,603],{"class":58},"?:",[48,605,606],{"class":587}," Platform\n",[48,608,609],{"class":50,"line":106},[48,610,611],{"class":122},"  \u002F** 编译命令行参数 *\u002F\n",[48,613,614,617,619,622,625,628,630,633],{"class":50,"line":119},[48,615,616],{"class":109},"  options",[48,618,603],{"class":58},[48,620,621],{"class":587}," Record",[48,623,624],{"class":58},"\u003C",[48,626,627],{"class":587},"string",[48,629,187],{"class":58},[48,631,632],{"class":587}," any",[48,634,635],{"class":58},">\n",[48,637,638],{"class":50,"line":126},[48,639,640],{"class":122},"  \u002F** 当前编译环境变量，需要开启 env 配置才有该数据 *\u002F\n",[48,642,643,646,648,650,652,654,656,659],{"class":50,"line":137},[48,644,645],{"class":109},"  envData",[48,647,603],{"class":58},[48,649,621],{"class":587},[48,651,624],{"class":58},[48,653,627],{"class":587},[48,655,187],{"class":58},[48,657,658],{"class":587}," string",[48,660,635],{"class":58},[48,662,663],{"class":50,"line":162},[48,664,665],{"class":58},"}\n",[21,667,668,669,672,673,676],{},"三个字段都是可选的。",[25,670,671],{},"envData"," 只在 ",[25,674,675],{},"env"," 配置开启时才有值。",[34,678,679],{"id":679},"示例",[21,681,682],{},"在构建前检查环境变量是否齐全：",[38,684,686],{"className":40,"code":685,"filename":42,"language":43,"meta":44,"style":44},"import process from 'node:process'\nimport { defineConfig } from '@uni-helper\u002Funh'\n\nexport default defineConfig({\n  env: true,\n  hooks: {\n    build({ platform, envData }) {\n      if (!envData?.VITE_API_BASE_URL) {\n        throw new Error(`缺少 VITE_API_BASE_URL，平台 ${platform}`)\n      }\n    },\n  },\n})\n",[25,687,688,705,723,727,739,753,761,777,801,831,836,840,844],{"__ignoreMap":44},[48,689,690,692,695,698,700,703],{"class":50,"line":51},[48,691,55],{"class":54},[48,693,694],{"class":62}," process ",[48,696,697],{"class":54},"from",[48,699,72],{"class":58},[48,701,702],{"class":75},"node:process",[48,704,79],{"class":58},[48,706,707,709,711,713,715,717,719,721],{"class":50,"line":82},[48,708,55],{"class":54},[48,710,59],{"class":58},[48,712,63],{"class":62},[48,714,66],{"class":58},[48,716,69],{"class":54},[48,718,72],{"class":58},[48,720,76],{"class":75},[48,722,79],{"class":58},[48,724,725],{"class":50,"line":88},[48,726,85],{"emptyLinePlaceholder":6},[48,728,729,731,733,735,737],{"class":50,"line":106},[48,730,91],{"class":54},[48,732,94],{"class":54},[48,734,63],{"class":97},[48,736,100],{"class":62},[48,738,103],{"class":58},[48,740,741,744,746,750],{"class":50,"line":119},[48,742,743],{"class":109},"  env",[48,745,113],{"class":58},[48,747,749],{"class":748},"sfNiH"," true",[48,751,752],{"class":58},",\n",[48,754,755,757,759],{"class":50,"line":126},[48,756,110],{"class":109},[48,758,113],{"class":58},[48,760,116],{"class":58},[48,762,763,765,767,769,771,773,775],{"class":50,"line":137},[48,764,314],{"class":109},[48,766,180],{"class":58},[48,768,184],{"class":183},[48,770,187],{"class":58},[48,772,195],{"class":183},[48,774,198],{"class":58},[48,776,116],{"class":58},[48,778,779,782,785,788,790,793,796,799],{"class":50,"line":162},[48,780,781],{"class":54},"      if",[48,783,784],{"class":109}," (",[48,786,787],{"class":58},"!",[48,789,671],{"class":62},[48,791,792],{"class":58},"?.",[48,794,795],{"class":62},"VITE_API_BASE_URL",[48,797,798],{"class":109},") ",[48,800,103],{"class":58},[48,802,803,806,809,812,814,817,820,823,826,829],{"class":50,"line":168},[48,804,805],{"class":54},"        throw",[48,807,808],{"class":58}," new",[48,810,811],{"class":97}," Error",[48,813,100],{"class":109},[48,815,816],{"class":58},"`",[48,818,819],{"class":75},"缺少 VITE_API_BASE_URL，平台 ",[48,821,822],{"class":58},"${",[48,824,825],{"class":62},"platform",[48,827,828],{"class":58},"}`",[48,830,159],{"class":109},[48,832,833],{"class":50,"line":174},[48,834,835],{"class":58},"      }\n",[48,837,838],{"class":50,"line":203},[48,839,165],{"class":58},[48,841,842],{"class":50,"line":235},[48,843,438],{"class":58},[48,845,846,848],{"class":50,"line":240},[48,847,444],{"class":58},[48,849,159],{"class":62},[21,851,852,853,856,857,860],{},"hook 抛出错误时，进程打印 ",[25,854,855],{},"Fatal error:"," 并以退出码 1 结束，",[25,858,859],{},"uni"," 命令不会执行。",[862,863,864],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":44,"searchDepth":82,"depth":82,"links":866},[867,868,869,870],{"id":36,"depth":82,"text":36},{"id":449,"depth":82,"text":449},{"id":542,"depth":82,"text":542},{"id":679,"depth":82,"text":679},false,"通过自定义hooks扩展unh功能，实现项目启动前后自定义逻辑","md","carbon:webhook",{},"\u002Funh\u002Fhooks",{"title":5,"description":872},"unh\u002F3.hooks","hPN44wdn6A8oxIIP3J_0ztUz83m2tjzET1noBqJsE3c",{"id":881,"title":882,"aside":6,"authors":7,"badges":7,"banner":7,"body":7,"breadcrumb":6,"collapse":871,"description":883,"editLink":6,"extension":884,"fullpage":871,"header":7,"icon":7,"main":7,"meta":885,"navBadges":7,"navTruncate":871,"navigation":886,"path":888,"prevNext":6,"seo":889,"stem":890,"toc":891,"__hash__":900},"content\u002Funh\u002F_dir.yml","unh","二次封装的启动命令，支持平台别名和自定义Hooks","yml",{"showTitle":871},{"redirect":887},"\u002Funh\u002Finstallation","\u002Funh\u002F_dir",{"title":882,"description":883},"unh\u002F_dir",{"links":892},[893,896],{"title":894,"icon":895,"to":16,"target":12},"点亮星星","lucide:star",{"title":897,"icon":898,"to":899,"target":12},"反馈问题","lucide:github","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Funh\u002Fissues","slDJxNvC8rO7mMtnt8-RsLXtYaZ0Eo-GZYY42hNl-8A",1795164923680]