# rnapptvdocs

**Repository Path**: gditv/rnapptvdocs

## Basic Information

- **Project Name**: rnapptvdocs
- **Description**: 一体化电视应用开发指南文档仓库
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一体化电视应用开发指南

> **适用对象**：在本平台上开发 React Native 应用的开发者。
>
> 平台团队统一维护 Native 基础设施，业务开发者无需编写 Native 代码。具备前端 React 开发经验即可上手。

## 文档导航

### 平台概览

| 文档 | 说明 |
|------|------|
| [平台概览](./00-overview.md) | 平台是什么、APK 底座能力、分包架构、与标准 RN 的差异 |

### RN 应用开发

#### 入门必读（按顺序阅读）

| 文档 | 说明 |
|------|------|
| [快速上手](./01-quick-start.md) | 环境搭建、创建业务包工程、本地运行与调试 |
| [架构设计](./02-architecture.md) | 基础包与业务包的分包架构、模块 ID 机制、页面注册 |

#### 核心参考

| 文档 | 说明 |
|------|------|
| [焦点机制详解](./14-focus-mechanism.md) | TV 端焦点系统的运行机制、搜索算法、视觉效果、边缘行为 |
| [私有组件](./03-components.md) | 平台提供的私有 UI 组件索引与用法 |
| [私有 API](./04-apis.md) | 平台提供的私有 JS/Native API 索引与用法 |
| [常见业务场景](./05-business.md) | 登录、导航、网络请求、列表等业务场景的实现模式 |

#### 进阶

| 文档 | 说明 |
|------|------|
| [构建与发布](./07-build-and-publish.md) | 基础包与业务包的构建流程、环境切换、发布上架 |
| [调试与监控](./08-debug-and-monitor.md) | 本地调试、远程调试（STB集成测试平台）、日志、崩溃监控 |
| [远程调试：TV 调试操作指南](./11-tv-debug-quick-start.md) | RN 应用、HTML 应用和调试 APK 的快速开始与租赁后排障 |
| [远程调试：DebugClaw 使用指南](./12-debugclaw.md) | DebugClaw 安装、登录、命令说明、远程调试和常见排障 |

#### 附录

| 文档 | 说明 |
|------|------|
| [平台原生能力参考](./06-native-modules.md) | 基础包中可用的 Native Module 及其 JS 调用方式 |
| [常见问题](./09-faq.md) | 常见问题与排查指南 |
| [第三方库兼容性](./10-third-party-libs.md) | 已知兼容/不兼容的第三方库列表 |

---

## 约定与术语

| 术语 | 含义 |
|------|------|
| **APK底座** | 平台提供的 Android APK 工程，内置基础包和 React Native 运行时。对业务开发者透明。 |
| **基础包** | 由平台团队维护，包含 RN 框架、通用依赖、平台私有组件与 API。所有业务包共享同一个基础包。 |
| **业务包** | 由业务开发者维护，仅包含业务 JS 代码。依赖基础包运行，打包时自动排除基础包已有的模块。 |
| **数据云平台** | 管理和运营内容数据的云平台，应用的业务数据均通过 HTTP 接口从该平台获取。 |

---

## 平台与标准 React Native 的快速对比

| 维度 | 标准 React Native | 本平台 |
|------|-------------------|--------|
| 定位 | 通用跨平台框架 | 面向电视端（Android TV）的定制化平台 |
| 构建方式 | Metro + Gradle/Xcode | Multibundler 分包构建 + APK 底座 |
| 包结构 | 单一 JS Bundle | 基础包 + 多个业务包 |
| 导航方案 | React Navigation（自行集成） | react-navigation 已内置在基础包中 |
| 组件与 API | 标准 RN 组件 | 标准组件 + 平台私有组件与 API |
| 调试工具 | Flipper / Chrome DevTools | Metro 终端日志 + ADB logcat |
| Native 开发 | 业务开发者可编写 Native Module | Native 层由平台团队统一维护，业务开发者不直接编写 |

> 详细的差异说明请阅读 [平台概览](./00-overview.md)。

---

## 反馈与贡献

如有疑问或建议，请微信扫码添加企业客服微信，客服会邀请您加入平台开发者交流群。

![企业客服微信](./images/contact.png)