跳到主要内容

创建 manifest.json

每个应用都需要有它的 manifest 文件,用以向钱包传递元信息。Manifest 是一个名为 tonconnect-manifest.json 的 JSON 文件,遵循以下格式:

{
"url": "<app-url>", // required
"name": "<app-name>", // required
"iconUrl": "<app-icon-url>", // required
"termsOfUseUrl": "<terms-of-use-url>", // optional
"privacyPolicyUrl": "<privacy-policy-url>" // optional
}

示例

您可以在下面找到一个 manifest 的示例:

{
"url": "https://ton.vote",
"name": "TON Vote",
"iconUrl": "https://ton.vote/logo.png"
}

最佳实践

  • 最佳实践是将 manifest 放置在您应用和库的根目录,例如 https://myapp.com/tonconnect-manifest.json。这样可以让钱包更好地处理您的应用,并提升与您应用相关的用户体验。
  • 确保 manifest.json 文件通过其 URL 可以被 GET 访问。

字段描述

字段要求描述
url必需应用 URL。将被用作 DApp 标识符。点击钱包中的图标后,将用来打开 DApp。推荐传递不带关闭斜杠的 url,例如 'https://mydapp.com' 而非 'https://mydapp.com/'。
name必需应用名称。可以简单,不会被用作标识符。
iconUrl必需应用图标的 URL。必须是 PNG、ICO 等格式,不支持 SVG 图标。最好传递指向 180x180px PNG 图标的 url。
termsOfUseUrl可选使用条款文档的 url。普通应用为可选,但对于放在 Tonkeeper 推荐应用列表中的应用则为必填。
privacyPolicyUrl可选隐私政策文档的 url。普通应用为可选,但对于放在 Tonkeeper 推荐应用列表中的应用则为必填。