@@ -133,7 +133,7 @@ const {
133
133
<h1>你好,来自{city}的友好访客!</h1>
134
134
```
135
135
136
- 如果你使用 TypeScript,你可以通过更新 ` src/env.d.ts ` 来使用 ` NetlifyLocals ` 来获得正确的类型 :
136
+ 如果你使用 TypeScript,你可以通过更新 ` src/env.d.ts ` 来使用 ` NetlifyLocals ` 来 [ 获得正确的类型 ] ( /zh-cn/guides/typescript/#扩展全局类型 ) :
137
137
138
138
``` ts title="src/env.d.ts"
139
139
type NetlifyLocals = import (' @astrojs/netlify' ).NetlifyLocals
@@ -321,6 +321,72 @@ export default defineConfig({
321
321
});
322
322
```
323
323
324
+
325
+ ### 本地开发功能
326
+
327
+ 当运行 ` astro dev ` 时,适配器会启用若干 Netlify 平台功能,以确保开发环境尽可能与生产环境一致。这些功能包括:
328
+
329
+ - 一个本地的 [ Netlify 图像 CDN] ( https://docs.netlify.com/build/image-cdn/overview/ ) 服务器。默认情况下用于 [ 图像支持] ( #netlify-图片-cdn-支持 )
330
+ - 一个本地的 [ Netlify Blobs] ( https://docs.netlify.com/build/data-and-storage/netlify-blobs/ ) 服务器。默认情况下用于 [ sessions] ( #sessions )
331
+ - 来自你的 Netlify 配置的 [ 重定向、重写] ( https://docs.netlify.com/manage/routing/redirects/overview/ ) 和 [ headers] ( https://docs.netlify.com/manage/routing/headers/ )
332
+ - 按需渲染的页面中访问的 [ Netlify 边缘上下文] ( #从你的站点访问-edge-上下文 )
333
+ - 来自你的 Netlify 站点的 [ 环境变量] ( https://docs.netlify.com/build/environment-variables/overview/ )
334
+
335
+ 当您的本地站点使用 ` netlify link ` [ 链接到 Netlify 站点] ( https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli/#link-and-unlink-sites ) 时,这些功能效果最佳。
336
+
337
+ 你可以在适配器配置中的 [ ` devFeatures ` ] ( #devfeatures ) 选项启用或禁用其中的一些功能。默认情况下,除环境变量外,所有功能均已启用。
338
+
339
+ #### ` devFeatures `
340
+
341
+ <p >
342
+ ** 类型:** ` boolean | object ` <br />
343
+ ** 默认值:** ` { images: true, environmentVariables: false } ` <br />
344
+ <Since v = " 6.5.1" pkg = " @astrojs/netlify" />
345
+ </p >
346
+
347
+ ` devFeatures ` 可以是布尔值,用于启用或禁用所有功能,或者是一个对象,用来启用特定功能。
348
+
349
+ ``` js title="astro.config.mjs" ins={7-12}
350
+ import { defineConfig } from ' astro/config' ;
351
+ import netlify from ' @astrojs/netlify' ;
352
+
353
+ export default defineConfig ({
354
+ // ...
355
+ adapter: netlify ({
356
+ devFeatures: {
357
+ // 在开发中启用 Netlify 图像 CDN 支持. 默认为 true。
358
+ images: false ,
359
+ // 在开发环境中注入 Netlify 环境变量。默认值为 false。
360
+ environmentVariables: true ,
361
+ },
362
+ }),
363
+ });
364
+ ```
365
+
366
+ ##### ` devFeatures.images `
367
+
368
+ <p >
369
+ ** 类型:** ` boolean ` <br />
370
+ ** 默认值:** ` true ` <br />
371
+ <Since v = " 6.5.1" pkg = " @astrojs/netlify" />
372
+ </p >
373
+
374
+ 在开发中启用对本地 [ Netlify 图像 CDN] ( https://docs.netlify.com/build/image-cdn/overview/ ) 的支持。
375
+
376
+ 这使用的是 Netlify 图像 CDN 的本地版本,而不是默认的 Astro 图像服务。
377
+
378
+ ##### ` devFeatures.environmentVariables `
379
+
380
+ <p >
381
+ ** 类型:** ` boolean ` <br />
382
+ ** 默认值:** ` false ` <br />
383
+ <Since v = " 6.5.1" pkg = " @astrojs/netlify" />
384
+ </p >
385
+
386
+ 将来自你的 Netlify 站点的环境变量注入到开发环境中。
387
+
388
+ 这使得你可以在开发环境中使用与生产环境相同的值。有关更多信息,包括如何为不同环境使用不同变量,请参阅 [ Netlify 关于环境变量的文档] ( https://docs.netlify.com/build/environment-variables/overview/ ) 。
389
+
324
390
## 实验性功能
325
391
326
392
以下功能当前可用,但在未来更新中可能会发生破坏性变更。如果你在项目中使用这些功能,请密切关注 [ ` @astrojs/netlify ` CHANGELOG] ( https://github.com/withastro/astro/tree/main/packages/integrations/netlify/CHANGELOG.md ) 以获取最新动态。
0 commit comments