NNext.js 中文网 GitHub

manifest.json

manifest.json 文件的 API 参考。

在 app 目录的根目录中添加或生成一个符合 Web Manifest 规范的 manifest.(json|webmanifest) 文件,以便为浏览器提供有关你的 Web 应用程序的信息。

静态 Manifest 文件#

app/manifest.json | app/manifest.webmanifest
{
  "name": "My Next.js Application",
  "short_name": "Next.js App",
  "description": "An application built with Next.js",
  "start_url": "/"
  // ...
}

生成 Manifest 文件#

添加一个返回 Manifest 对象的 manifest.js 或 manifest.ts 文件。

小知识:manifest.js 是一种特殊的 Route Handler,默认情况下会被缓存,除非它使用了请求时 API或动态配置选项。

app/manifest.ts
import type { MetadataRoute } from 'next'

export default function manifest(): MetadataRoute.Manifest {
  return {
    name: 'Next.js App',
    short_name: 'Next.js App',
    description: 'Next.js App',
    start_url: '/',
    display: 'standalone',
    background_color: '#fff',
    theme_color: '#fff',
    icons: [
      {
        src: '/favicon.ico',
        sizes: 'any',
        type: 'image/x-icon',
      },
    ],
  }
}
app/manifest.js
export default function manifest() {
  return {
    name: 'Next.js App',
    short_name: 'Next.js App',
    description: 'Next.js App',
    start_url: '/',
    display: 'standalone',
    background_color: '#fff',
    theme_color: '#fff',
    icons: [
      {
        src: '/favicon.ico',
        sizes: 'any',
        type: 'image/x-icon',
      },
    ],
  }
}

Manifest 对象#

Manifest 对象包含大量选项,这些选项可能会因新的 Web 标准而更新。有关所有当前选项的信息,如果使用 TypeScript,请在代码编辑器中参考 MetadataRoute.Manifest 类型,或查阅 MDN 文档。

Next.js 中文网