Skip to content

Latest commit

 

History

History
50 lines (29 loc) · 2.83 KB

CONTRIBUTING.md

File metadata and controls

50 lines (29 loc) · 2.83 KB

How to Contribute

Thank you for your interest in Ghosten Player! This guide will help you understand how to contribute to the repository.

Warning

The following documentation only covers key points in the development process.

Setting Up the Development Environment

Install the Flutter SDK from the download page.

The Flutter SDK version must match the one used in the GitHub Action build; otherwise, the build may fail.
Refer to:

flutter-version: '3.32.8'

If you are new to Flutter, detailed installation instructions can be found in the official documentation.

Supported Devices

The app runs only on arm devices (including emulators) with Android version 6+.

Starting the Project

Use flutter run --flavor=mobile for the mobile version and flutter run --flavor=tv --target=lib/main_tv.dart for the TV version.

Data Preparation

Currently, mock data is not supported. You can add your own data by referring to the Wiki.

If you are using Windows as your development machine, it is recommended to create a WebDAV server using the built-in Internet Information Services (IIS).
Then create a test directory inside it to simulate a real-world usage environment.
Reference documentation

Media Scraping

If you use themoviedb for scraping, you need to prepare an api_key and assign it as the default value for the following variable. It can also be passed via environment variables.
See the reference documentation for examples. If not provided, themoviedb scraping will be disabled.

const tmdbApiKey = String.fromEnvironment('TMDB_API_KEY');

Contribution Scope

Currently, only front-end contributions are supported, including UI, interaction, internationalization, etc. Player-related code has been moved to this repository.

Localization

Currently, only Simplified Chinese and English are supported. The English translation may not be very accurate. If you are a native English speaker or proficient in English, please help us improve the translations.

If you are a speaker of other languages, you can add new language translations.

Internationalization documentation: https://docs.flutter.dev/ui/internationalization
The internationalization files are located in the lib/l10n directory.