Streamyfin开发者指南：如何为这个开源Jellyfin客户端贡献代码

Streamyfin是一个基于Expo构建的开源Jellyfin客户端，专注于为用户提供流畅的流媒体体验。作为一款现代化的Jellyfin客户端，它支持跳过片头片尾、章节预览、离线下载和投屏等核心功能。

🚀 环境搭建与项目初始化

克隆代码仓库

首先，您需要克隆Streamyfin的代码仓库：

git clone https://gitcode.com/gh_mirrors/st/streamyfin
cd streamyfin

安装依赖

Streamyfin使用Bun作为包管理器，确保您已安装Node.js 20或更高版本：

bun i && bun run submodule-reload

开发环境配置

项目使用Expo开发框架，支持iOS和Android平台：

• iOS开发：需要安装Xcode和相关工具链
• Android开发：需要安装Android Studio和相应的SDK

Streamyfin首页展示了继续观看、即将观看、分类和推荐等核心模块

🛠️ 项目架构概览

Streamyfin采用现代化的React Native架构，主要包含以下核心模块：

应用结构

• app/ - 主要应用路由和页面组件
• components/ - 可复用的UI组件库
• modules/ - 播放器模块（MPV、VLC、SF Player等）
• providers/ - 全局状态管理和服务提供者

核心技术栈

• Expo 54 - 跨平台开发框架
• React Native 0.81.5 - 移动应用开发
• TypeScript - 类型安全的JavaScript
• NativeWind - 使用Tailwind CSS的样式解决方案

📝 代码贡献流程

1. 创建功能分支

在开始开发前，请从主分支创建功能分支：

git checkout -b feature/your-feature-name

2. 代码规范与质量保证

Streamyfin使用BiomeJS进行代码格式化和静态分析：

# 代码检查
bun run typecheck

# 代码格式化
bun run format

# 完整测试
bun run test

剧集详情页展示完整的元数据信息和播放控制选项

3. 提交Pull Request

完成开发后，提交Pull Request并确保：

• ✅ 所有测试通过
• ✅ 代码符合BiomeJS规范
• ✅ 包含适当的测试用例
• ✅ 更新相关文档

🔧 核心开发模块

播放器模块开发

Streamyfin支持多种播放器后端，位于 modules/ 目录：

• mpv-player/ - MPV播放器集成
• vlc-player/ - VLC播放器支持
• sf-player/ - SF播放器实现

每个播放器模块都包含：

• Android和iOS原生代码
• TypeScript类型定义
• Expo模块配置

组件开发规范

所有可复用组件位于 components/ 目录，遵循统一的接口设计：

// 组件Props接口示例
interface ComponentProps {
  title: string;
  onPress?: () => void;
  variant?: 'primary' | 'secondary';
}

🌍 国际化贡献

Streamyfin支持多语言，翻译文件位于 translations/ 目录。您可以通过以下方式贡献翻译：

1. 选择目标语言文件（如 zh-CN.json）
2. 添加或更新翻译条目
3. 提交Pull Request

搜索功能支持按电影、剧集、剧集等多维度分类

🧪 测试与调试

运行开发版本

# iOS开发版本
npm run ios

# Android开发版本  
npm run android

# TV版本（添加:tv后缀）
npm run ios:tv

代码质量检查

项目配置了完整的CI/CD流程，包括：

• 类型检查 - TypeScript编译验证
• 代码格式化 - 统一的代码风格
• 静态分析 - 潜在问题检测

📋 提交规范

请遵循以下提交信息格式：

feat: 添加新的播放器控制组件
fix: 修复下载进度显示问题
docs: 更新组件使用文档

🔄 持续集成流程

Streamyfin的CI流程会自动执行：

1. 依赖安装 - 确保所有依赖正确安装
2. 代码检查 - 运行完整的质量检查
3. 构建测试 - 验证应用构建是否成功

下载管理界面支持按内容类型分组管理离线内容

🎯 贡献者指南

新功能开发

在开发新功能前，请：

1. 在GitHub Issues中创建功能提案
2. 与核心团队讨论实现方案
3. 确保功能符合项目整体架构

Bug修复流程

1. 复现问题并创建详细报告
2. 分析根本原因
3. 编写修复代码和测试用例

📞 获取帮助

在开发过程中遇到问题，可以通过以下方式获取支持：

• Discord社区 - 实时技术讨论
• GitHub Issues - 问题追踪和功能请求
• 开发文档 - 详细的API参考和架构说明

✨ 成为核心贡献者

持续为Streamyfin做出高质量贡献的开发者，有机会成为项目的核心贡献者，获得：

• 🔧 Beta版本自动访问权限
• 🎯 项目决策参与权
• 🤝 社区认可和荣誉

通过参与Streamyfin的开发，您不仅能够提升自己的技术能力，还能为开源社区做出实际贡献，帮助更多用户享受更好的流媒体体验。