GitHub Store

🗺️ プロジェクト概要

GitHub Store は、オープンソースソフトウェアの発見とインストールを簡単にするために設計された、GitHub リリース向けのクロスプラットフォームアプリストアです。インストール可能なバイナリ（APK、EXE、DMG、AppImage、DEB、RPM）を自動的に検出し、ワンクリックインストール、アップデート追跡、そしてアプリストア風のクリーンなインターフェースでリポジトリ情報を提供します。

Android および Desktop プラットフォーム向けに Kotlin Multiplatform と Compose Multiplatform で構築されています。

[!CAUTION] 自由でオープンソースな Android が危機に瀕しています。Google は Android を閉鎖的なプラットフォームに変え、好きなアプリをインストールするというあなたの基本的な自由を制限しようとしています。声を上げてください – keepandroidopen.org.

📔 Wiki とリソース

FAQ や役立つ情報は GitHub Store の Wiki をご覧ください

🌐 ウェブサイト: github-store.org 💬 Discord: コミュニティに参加する 📜 プライバシーポリシー: github-store.org/privacy-policy

📋 法的事項

GitHub Store は GitHub, Inc. と無関係の独立したオープンソースプロジェクトです。
この名称はアプリの機能（GitHub リリースの発見）を説明するものであり、商標の所有権を意味するものではありません。
GitHub® は GitHub, Inc. の登録商標です。

🔃 ダウンロード

[!IMPORTANT] macOS ユーザーの方へ: Apple が GitHub Store を検証できないという警告が表示される場合があります。これはアプリが App Store 外で配布されており、まだ公証されていないためです。システム設定 → プライバシーとセキュリティ → このまま開く から許可してください。

🏆 掲載メディア

🚀 機能

• スマートな発見

  • 時間ベースのフィルター付きで「Trending」「Hot Release」「Most Popular」プロジェクトのホームセクション。
  • 有効なインストール可能ファイルを持つリポジトリのみが表示されます。
  • Android/デスクトップユーザーが関連アプリを最初に見られるよう、プラットフォームを考慮したトピックスコアリング。
  • 関連性ランキングとパフォーマンスが向上した刷新された検索。

• リリースブラウザとインストール

  • 最新版だけでなく、任意のリリースから閲覧・インストールできるリリースセレクター。
  • 各リポジトリのすべてのリリースを取得。
  • 「最新版をインストール」ワンアクション、および利用可能なすべてのリリースとインストーラーの展開可能なリスト。
  • 自動互換性チェック付きの手動インストールオプション。

• 充実した詳細画面

  • アプリ名、バージョン、共有アクション。
  • スター数、フォーク数、オープンイシュー数。
  • レンダリングされた README コンテンツ（「このアプリについて」）。
  • 選択した任意のリリースの Markdown 形式リリースノート。
  • プラットフォームラベルとファイルサイズ付きのインストーラーリスト。
  • ディープリンクサポート — URL からリポジトリ詳細を直接開く。
  • 開発者のリポジトリと活動を探索するための開発者プロフィール画面。

• アプリ管理

  • インストール済みアプリを GitHub Store から直接開く、アンインストール、ダウングレード。
  • Android：APK アーキテクチャマッチング（armv7/armv8）、パッケージ監視、アップデート追跡。
  • Desktop（Windows/macOS/Linux）：インストーラーをユーザーのダウンロードフォルダーにダウンロードし、デフォルトハンドラーで開く。

• スター付きリポジトリ

  • アプリ内から GitHub のスター付きリポジトリを保存・閲覧。

• ネットワークとパフォーマンス

  • 設定可能なネットワークルーティングのための動的プロキシサポート。
  • より高速な読み込みと API 使用量削減のための強化されたキャッシュシステム。

🔍 自分のアプリを GitHub Store に表示させるには？

GitHub Store はプライベートインデックスや手動キュレーションルールを一切使用していません。
以下の条件を満たせば、プロジェクトは自動的に表示される可能性があります：

1. GitHub 上の公開リポジトリ

   • 可視性は public に設定されている必要があります。

2. 最新リリースにインストール可能なファイル

   • 最新リリースに、サポートされている拡張子のファイルが少なくとも 1 つ含まれている必要があります：
     • Android: .apk
     • Windows: .exe, .msi
     • macOS: .dmg, .pkg
     • Linux: .deb, .rpm, .AppImage
   • GitHub Store は GitHub が自動生成するソースコードアーカイブ（Source code (zip) / Source code (tar.gz)）を無視します。

3. 検索 / トピックスによる発見可能性

   • リポジトリは GitHub の公開検索 API 経由で取得されます。
   • トピックス、言語、説明がランキングに影響します：
     • Android アプリ：android、mobile、apk などのトピックス。
     • デスクトップアプリ：desktop、windows、linux、macos、compose-desktop、electron などのトピックス。
   • スターが少しでもあると、Trending/Hot Release/Most Popular セクションに表示される可能性が高まります。

リポジトリがこれらの条件を満たしている場合、GitHub Store は検索を通じてそれを見つけ、自動的に表示できます — 手動での申請は不要です。

✅ メリット / GitHub Store を使う理由

• GitHub リリースを手動で探す手間がなくなる あなたのプラットフォーム向けにバイナリを実際に提供しているリポジトリだけを表示。

• インストール済みアプリを把握している GitHub Store 経由でインストールされたアプリ（Android）を追跡し、新しいリリースが利用可能になると通知。GitHub で再度検索することなく更新できます。

• 常に最新 インストールはデフォルトで最新公開リリースを使用。リリースセレクターを通じて以前のリリースも閲覧・インストール可能。

• オープンソースで拡張可能
  ネットワーク、ドメインロジック、UI が明確に分離された KMP で記述 — フォーク、拡張、カスタマイズが簡単。

🔐 GitHub Store APK 署名証明書

すべての公式 GitHub Store リリースは以下の証明書フィンガープリントで署名されています：

SHA-256: B7:F2:8E:19:8E:48:C1:93:B0:38:C6:5D:92:DD:F7:BC:07:7B:0D:B5:9E:BC:9B:25:0A:6D:AC:48:C1:18:03:CA

🔑 GitHub OAuth の設定

要約

1. GitHub OAuth App を作成する
2. Client ID をコピーする
3. local.properties に記入する

1 - GitHub OAuth App の作成

以下に移動： GitHub → Settings → Developer settings → OAuth Apps → New OAuth App

Create application をクリックします。

2 - Client ID のコピー

作成後、GitHub は以下を表示します：

• Client ID ← これが必要なもの
• Client Secret ← ❗ このプロジェクトでは不要

3 - プロジェクトへの追加

プロジェクトの local.properties ファイル（プロジェクトのルート）を開き、以下を追加：

GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE

4 - 同期と実行

プロジェクトを同期してアプリを実行します。これで GitHub でサインインできるようになります。

❗ 重要な注意事項

• local.properties は Git にコミットされない ため、Client ID はローカルに留まります。
• このプロジェクトに必要なのは Client ID のみです（Client Secret は不要）。
• 各開発者は開発用に独自の OAuth App を作成する必要があります。

☕ プロジェクトを支援する

GitHub Store は高校生によって開発・メンテナンスされています。あなたのサポートが以下を可能にします：

✅ アプリをバグのない状態に保つ — イシューに対応し、修正を迅速にリリースする
✅ コミュニティからのリクエスト機能を追加する — ユーザーが本当に必要とするものを実装する

💖 支援方法

今すぐスポンサーできない場合は？ 大丈夫！以下の方法でも支援できます：

• ⭐ このリポジトリにスターを付ける — 他の人が GitHub Store を発見するのに役立ちます
• 🐛 バグを報告する — アプリをすべての人のために改善します
• 📢 友人にシェアする — 他の開発者や友人に広めてください！
• 💬 Discord に参加する — あなたのフィードバックがロードマップを形成します

金銭的か否かを問わず、あらゆる形のサポートが大きな意味を持ち、このプロジェクトを生き続けさせます。ありがとうございます！

⚠️ 免責事項

GitHub Store は、サードパーティの開発者によって GitHub に既に公開されているリリースファイルの発見とダウンロードを支援するだけです。
これらのダウンロードのコンテンツ、安全性、動作はそれぞれの作者と配布者の責任であり、このプロジェクトとは無関係です。

GitHub Store を使用することで、ダウンロードしたソフトウェアのインストールと実行は自己責任で行うことを理解し同意したものとみなされます。
このプロジェクトは、いかなるインストーラーが安全であること、マルウェアを含まないこと、または特定の目的に適していることを審査、検証、保証するものではありません。

スター履歴

📄 ライセンス

GitHub Store は Apache License, Version 2.0 の下でリリースされます。

Copyright 2025 rainxchzed

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.