克隆模板
您可以使用以下命令将 Mini App 模板克隆到本地机器:安装依赖
将 .env.example 复制为 .env.local
运行模板
在 Farcaster Embed 工具中查看应用
Farcaster 提供了一个方便的 Embed 工具,可用于在您发布 Mini App 之前进行检查。 不幸的是,该嵌入工具只能与远程 URL 一起使用。输入 localhost URL 是不起作用的。 作为一种变通方案,您可以使用cloudflared 或 ngrok 等工具让本地应用可以远程访问。在本指南中我们将使用 cloudflared。
安装 Cloudflared
暴露 localhost
在终端中运行以下命令:在 .env.local 文件中设置 NEXT_PUBLIC_URL 环境变量
使用提供的 URL
cloudflared 会生成一个随机子域名并在终端打印,以供您使用。所有到该 URL 的流量都会被转发到您的本地服务器。
将提供的 URL 输入到 Farcaster Embed 工具 中。

自定义 Mini App Embed
Mini App Embed 是当应用的 URL 被分享时,Mini App 出现在 feed 或聊天中的方式。 Mini App Embed 看起来像这样:
app/page.tsx 来自定义它:
app/page.tsx
public/images 文件夹中的图片。
在您满意所做的更改之后,请点击 Embed 工具中的 Refetch 以获取最新配置。
如果您在本地开发,请确保您的 Next.js 应用正在本地运行,且 cloudflare tunnel 处于打开状态。
自定义启动画面
打开 Mini App 时,用户首先看到的是启动画面:
app/page.tsx 文件来自定义启动画面。
app/page.tsx
splashImageUrl,您可以修改 URL,或替换模板 public/images 文件夹中的图片。
修改 Mini App
打开模板 Mini App,您应会看到如下界面:
components/pages/app.tsx 文件中:
components/pages/app.tsx
访问用户上下文

username、fid、displayName、pfpUrl 等字段。
该模板提供了一个有用的 hook useMiniAppContext,您可以使用它来访问这些字段:
components/Home/User.tsx
components/Home/User.tsx 文件中提供了类似示例。
您可以在 此处 了解更多关于 Context 的信息。
执行 App Actions
Mini Apps 能够执行提升用户体验的原生 actions!
例如:
addFrame:允许用户将应用保存(收藏)到一个专门的部分composeCast:允许 Mini App 提示用户使用预填的文本和媒体进行 castviewProfile:在客户端原生 UI 中展示 Farcaster 用户的个人资料
useMiniAppContext hook 便捷访问这些 actions 的方式!
components/Home/FarcasterActions.tsx
components/Home/FarcasterActions.tsx 文件中找到。
触发钱包操作

components/Home/WalletActions.tsx 文件中提供了相应示例。
components/Home/WalletActions.tsx

