該模板演示了開發人員如何使用以下技術和庫在Telegram Mini Apps平台上實現Web應用程序:
使用PNPM創建模板。因此,也需要將其用於此項目。使用其他軟件包經理,您將收到相應的錯誤。
如果您剛剛克隆了此模板,則應使用命令安裝項目依賴項:
pnpm install該項目包含以下腳本:
dev在開發模式下運行應用程序。dev:https 。使用自簽名的SSL證書以開發模式運行應用程序。build 。構建生產應用程序。start 。在生產模式下啟動下一服務。 JS服務器。lint 。運行ESLINT以確保代碼質量符合所需的標準。要運行腳本,請使用pnpm run命令:
pnpm run {script}
# Example: pnpm run build 在開始之前,請確保您已經創建了電報機器人。這是有關如何做的綜合指南。
儘管迷你應用程序設計為在電報應用程序中打開,但在開發過程中,您仍然可以在電報之外開發和測試它們。
要在開發模式下運行應用程序,請使用dev腳本:
pnpm run dev之後,您將在終端中看到類似的消息:
▲ Next.js 14.2.3
- Local: http://localhost:3000
✓ Starting...
✓ Ready in 2.9s要查看應用程序,您需要在瀏覽器中打開Local鏈接(在此示例中http://localhost:3000 )。
重要的是要注意,此模板中的某些庫,例如@telegram-apps/sdk ,不打算在電報之外使用。
然而,它們似乎正常運行。這是因為在應用程序的Root組件中導入的src/hooks/useTelegramMock.ts文件採用了mockTelegramEnv函數來模擬Telegram環境。此技巧使應用程序在基於電報的環境中運行。因此,除非您完全理解其含義,否則不要在生產模式中使用此功能。
儘管可以在電報之外運行應用程序,但建議在電報中開發它,以最準確地表示其現實世界功能。
要在電報中運行應用程序,@botfather需要HTTPS鏈接。
該模板已經提供了一個解決方案。
要檢索使用HTTPS協議的鏈接,請考慮使用dev:https腳本:
$ pnpm run dev:https
▲ Next.js 14.2.3
- Local: https://localhost:3000
✓ Starting...
✓ Ready in 2.4s在瀏覽器中訪問Local鏈接( https://localhost:3000 ),您將看到以下警告:

此瀏覽器警告是正常的,只要站點安全,就可以安全地忽略。單擊Proceed to localhost (unsafe)按鈕繼續並查看應用程序。
正確顯示該應用程序後,提交鏈接https://127.0.0.1:3000 https://localhost:3000被Botfather視為無效)為@BotFather的迷你APP鏈接。然後,導航到https://web.telegram.org/k/,找到您的機器人,然後啟動Telegram Mini應用程序。這種方法提供了完整的發展經驗。
部署您的next.js應用的最簡單方法是使用Next.js的創建者的Vercel平台。
請查看下一個。 JS部署文檔以獲取更多詳細信息。