ルール:

MoeKoe Music

# MoeKoe Music Mobile

オープンソースでシンプルで高颜值のサードパーティーKuGou Musicのモバイル端末プレイヤー

Expo / React Nativeに基づいて構築され、MoeKoeMusic デスクトップ版のモバイル版実装です

🌎 GitHubリポジトリ   |  
📦️ ダウンロードパッケージ   |  
💬 ブログアクセス   |  
🏠 プロジェクトホームページ

オープンソースでシンプルで高颜值のサードパーティーKuGou Musicのモバイル端末プレイヤー

Expo / React Nativeに基づいて構築され、MoeKoeMusic デスクトップ版のモバイル版実装です

Expo SDK
React Native
TypeScript
License
Platform


✨ 特徴

📝 Todoリスト

📸 プレビュー

スクリーンショット 1スクリーンショット 2スクリーンショット 3
スクリーンショット 4スクリーンショット 5スクリーンショット 6

🚀 快速スタート

環境要件

開発と実行

# リポジトリをクローン(api submoduleを含む)
git clone --recurse-submodules https://github.com/MoeKoeMusic/MoeKoeMusic-Mobile.git
cd MoeKoeMusic-Mobile

# 依存関係をインストール
npm install
npm --prefix api install

# モバイル端末APIエントリを生成(api/ 更新後は再実行が必要)
npm run generate:mobile-api

# 開発サーバーを起動
npx expo start

クローン時にsubmoduleが欠けている場合は、git submodule update --initを実行して補完できます。

バンドルとビルド

プロジェクトはEAS Build を使用しています:

# デベロップメントクライアント(開発版)
eas build --profile development --platform android

# プレビューバージョン(内部分配)
eas build --profile preview --platform android

# プロダクションバージョン
eas build --profile production --platform all

🏗️ プロジェクト構造

├── api/                    # KuGouMusicApi(git submodule)
├── scripts/
│   └── generate-mobile-api-entry.mjs   # api/moduleをスキャンしてモバイル端末エントリを生成
├── src/
│   ├── app/                # expo-router ルーティング
│   │   ├── (tabs)/         # ホーム、発見、マイページ
│   │   ├── player.tsx      # フルスクリーンプレイページ
│   │   ├── search.tsx      # 検索ページ
│   │   ├── login.tsx       # ログインページ
│   │   └── playlist|album|rank/[id].tsx  # 詳細ページ
│   ├── components/ui/      # 一般的な UI コンポーネント(歌詞、プレイリスト、ミニプレイヤーなど)
│   ├── features/           # ビジネスモジュール(プレイヤー / 発見 / 検索 / アカウント ...)
│   ├── lib/kugou-api/      # アプリ内 API ランタイムアダプテーションレイヤー
│   ├── hooks/              # 一般的な Hooks
│   └── constants/          # トピックとレイアウトの常量
├── app.json                # Expo アプリケーション設定
└── eas.json                # EAS ビルド設定

🔧 テクノロジースタック

カテゴリ プラットフォーム
フレームワーク Expo SDK 57 + React Native 0.86 + React 19(React Compilerの有効化)
ルーティング expo-router (ファイルルーティング + Typed Routes)
UI Tamagui v2
オーディオ expo-audio (バックグラウンドプレイをサポート)
アニメーション react-native-reanimated 4
データソース KuGouMusicApi (アプリ内で実行、デプロイメント不要)

🤝 関連プロジェクト

💬 貢献

どんな形でも歓迎します!

  1. このリポジトリをフォーク
  2. 特徴分支を作成:git checkout -b feat/amazing-feature
  3. 変更をコミット:git commit -m 'feat: add amazing feature'
  4. ブランチをプルリクエストで送信

問題が見つかったり機能の提案があれば、Issue に提出してください。

⚠️ 免責事項

  1. このプロジェクトは学習と技術研究のためにのみ使用してください、商業用途には使用しないでください。
  2. このプロジェクトは、任何のオーディオリソースを保存、配布しません、すべてのデータは酷狗音楽の公式インターフェースから取得されます。
  3. 音楽の著作権は酷狗音楽および関連する権利所有者に帰属します、正規の音楽をサポートしてください。
  4. このプロジェクトの使用から生じるすべての結果はユーザー自身の責任です、開発者とは関係ありません。

📄 ライセンス

このプロジェクトはGPL-2.0 Licenseに基づいてオープンソースです。

著作権表示

著者: MoeJue

リンク: https://ja.moejue.cn/posts/342/

ライセンス: クリエイティブ・コモンズ表示-非営利-継承4.0国際ライセンス

この作品は、クリエイティブ・コモンズ表示-非営利-継承4.0国際ライセンスに基づいてライセンスされています。

検索を開始

キーワードを入力して記事を検索

↑↓
↵
ESC
⌘K ショートカット