跳到内容

manifest.json

app 目录的 根目录 中添加或生成一个 manifest.(json|webmanifest) 文件,该文件符合 Web Manifest 规范,以便为浏览器提供有关您的 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.jsmanifest.ts 文件,该文件返回一个 Manifest 对象

须知:manifest.js 是特殊的路由处理程序,默认情况下会被缓存,除非它使用动态 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',
      },
    ],
  }
}

Manifest 对象

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