@telegram-apps

这是一个单一代码仓库，包含所有与Telegram小程序平台上舒适安全的TypeScript开发相关的包。要了解特定包的更多信息，请查看它们各自的文档。

⚠️ 使用@telegram-apps包时，您不能安装Telegram提供的单个文件SDK - telegram-web-app.js。同时使用@telegram-apps包和telegram-web-app.js肯定会导致错误。

包

@telegram-apps/sdk

从零开始构建的TypeScript库，用于与Telegram小程序功能无缝通信。

这个库的代码旨在简化开发人员与Telegram小程序交互的过程。它由几个独立的组件组成，每个组件负责Telegram小程序生态系统的特定方面。

在开始使用SDK之前，我们强烈建议您熟悉Telegram小程序的文档，以掌握平台的基本概念。

@telegram-apps/sdk-react

客户端SDK的React JS绑定。包括钩子、组件和实用工具，方便在Telegram小程序平台上使用React JS。

@telegram-apps/sdk-solid

客户端SDK的Solid JS绑定。包括钩子、组件和实用工具，方便在Telegram小程序平台上使用Solid JS。

@telegram-apps/init-data-node

该包提供了在服务器端处理Telegram小程序初始化数据的实用工具。要了解更多关于初始化数据及其用法的信息，请参阅文档。

@telegram-apps/solid-router-integration

Telegram小程序Navigator与@solidjs/router的集成。

@telegram-apps/react-router-integration

Telegram小程序Navigator与react-router-dom的集成。

为什么不使用Telegram SDK

为什么要创建像@telegram-apps这样的项目，当平台所有者已经提供了现有解决方案时？答案很简单：目前提供的解决方案（SDK）似乎不符合所需的最低质量标准。当然，"质量"这个术语相当具体和主观，但本节应该使其更加客观。

这个项目诞生于对Telegram提供的解决方案telegram-web-app.js的研究过程中，该解决方案被认为是Telegram小程序唯一存在的官方SDK。因此，本节描述的所有要点都与此包有关。

由于篇幅较大，完整的动机描述已移至单独的文档中。

贡献

我们感谢任何形式的贡献。要开始贡献，请遵循贡献指南。