# @flagship\.io/react-sdk 中文文档

规范地址：https://npmcn.com/package/%40flagship.io/react-sdk/

版本：5\.2\.4
npm 元数据更新时间：2026-09-25T13:30:07.273Z
中文译文更新时间：2026-11-14T21:12:01.182Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40flagship.io/react-sdk
原文对照：https://npmcn.com/package/%40flagship.io/react-sdk/?lang=original
项目主页：https://github.com/flagship-io/flagship-react-sdk
源码仓库：https://github.com/flagship-io/flagship-react-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：268 kB，49 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react \>=16\.8\.0
- 首次发布：2020-04-07T07:15:36.215Z
- 最新版本发布：2026-07-02T15:13:08.598Z
- 近 30 天下载量：23227（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：159（近 12 个月 5 个）

## 中文简介

旗舰 REACT SDK

## 安装

```sh
npm install @flagship.io/react-sdk
```

也可以使用：`pnpm add @flagship.io/react-sdk`、`yarn add @flagship.io/react-sdk`、`bun add @flagship.io/react-sdk`

## README

[![Test](https://github.com/flagship-io/flagship-ts-sdk/actions/workflows/ci_push.yml/badge.svg)](https://github.com/flagship-io/flagship-ts-sdk/actions/workflows/ci_push.yml) [![codecov](https://codecov.io/gh/flagship-io/flagship-ts-sdk/branch/main/graph/badge.svg?token=IW0NWPTPSH)](https://codecov.io/gh/flagship-io/flagship-ts-sdk) [![npm version](https://badge.fury.io/js/@flagship.io%2Fjs-sdk.svg)](https://badge.fury.io/js/@flagship.io%2Fjs-sdk)

## 关于旗舰

​ ![drawing](https://www.abtasty.com/wp-content/uploads/2024/01/cropped-logo-abtasty-green.png) ​ [AB的旗舰味道](https://www.abtasty.com/) 是现代工程和产品团队的特色标志平台。 它通过将代码部署与这些发布区分开来消除未来发布的风险:bulb:有旗舰,你完全控制了发布过程. 你可以这样: ​

-   通过远程配置打开或关闭特性 .
-   自动推出您的特性,以逐渐监控性能,并收集您最相关的用户的反馈.
-   如果在生产试验中出现任何问题,则取消任何特性.
-   通过根据某些用户属性授权访问一个特性来分割用户.
-   进行A/B测试,方便地将特性变化分配给用户群体. ​ ​ Flagship还允许您从我们许多可用的SDK或直接通过REST API来选择任何对您有效的执行方法. 此外,我们的架构以多云供应商为基础,提供高性能和高度可扩展的管理服务. ​ **学习更多:** ​
-   [解决办法概述](https://www.abtasty.com/feature-experimentation/) - 发现Flagship如何帮助你管理你的释放 并运行生产实验
-   [文档](https://docs.abtasty.com/server-side/sdks/sdk-overview) - 我们的Dev门户,有向导、如何投放、API和SDK参考
-   [报名免费审判](https://www.abtasty.com/get-a-demo/) - 试出旗舰免费,看看如何帮助你管理你的释放 和运行实验生产
-   [特征标记指南](https://docs.abtasty.com/feature-experimentation-and-rollout) - 你需要了解与地标有关的使用案例
-   [博客](https://www.abtasty.com/resources/) - 关于释放管理的额外资源

## 常见问题

### @flagship\.io/react-sdk 是什么？

旗舰 REACT SDK

### 如何安装 @flagship\.io/react-sdk？

在项目目录运行 npm install @flagship\.io/react-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16\.8\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @flagship\.io/react-sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @flagship\.io/react-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @flagship\.io/react-sdk 可以商用吗？

@flagship\.io/react-sdk 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @flagship\.io/react-sdk 的下载量有多少？

根据 npm 官方下载统计，@flagship\.io/react-sdk 在 2026/10/15 – 2026/11/13 这 30 天内被下载 23,227 次，日均约 774 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @flagship\.io/react-sdk 还在维护吗？

最新版本 5\.2\.4 发布于 2026/07/02（4 个月前）；至今共发布 159 个版本，其中过去 12 个月发布了 5 个；首次发布于 2020/04/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。