GitHub Store

🗺️ Przegląd projektu

GitHub Store to wieloplatformowy sklep z aplikacjami dla wydań z GitHuba, zaprojektowany w celu uproszczenia odkrywania i instalowania oprogramowania open source. Automatycznie wykrywa instalowalne pliki binarne (APK, EXE, DMG, AppImage, DEB, RPM), oferuje instalację jednym kliknięciem, śledzi aktualizacje i prezentuje informacje o repozytoriach w przejrzystym interfejsie w stylu sklepu z aplikacjami.

Zbudowany z użyciem Kotlin Multiplatform i Compose Multiplatform na platformy Android i Desktop.

[!CAUTION] Wolny i otwartoźródłowy Android jest zagrożony. Google zamieni Androida w zamkniętą platformę, ograniczając Twoją podstawową wolność instalowania wybranych aplikacji. Wyraź swoje zdanie – keepandroidopen.org.

📔 Wiki i zasoby

Sprawdź Wiki GitHub Store, aby znaleźć odpowiedzi na najczęściej zadawane pytania i przydatne informacje

🌐 Strona internetowa: github-store.org 💬 Discord: Dołącz do społeczności 📜 Polityka prywatności: github-store.org/privacy-policy

📋 Informacja prawna

GitHub Store jest niezależnym projektem open source, niezwiązanym z GitHub, Inc. Nazwa opisuje funkcjonalność aplikacji (odkrywanie wydań z GitHuba) i nie sugeruje własności znaku towarowego. GitHub® jest zarejestrowanym znakiem towarowym GitHub, Inc.

🔃 Pobierz

[!IMPORTANT] Użytkownicy macOS: Możesz zobaczyć ostrzeżenie, że Apple nie może zweryfikować GitHub Store. Dzieje się tak, ponieważ aplikacja jest dystrybuowana poza App Store i nie jest jeszcze notaryzowana. Zezwól na nią w Ustawienia systemowe → Prywatność i bezpieczeństwo → Otwórz mimo to.

🏆 Wyróżniony w

🚀 Funkcje

• Inteligentne odkrywanie

  • Sekcje na stronie głównej dla projektów "Trending", "Hot Release" i "Most Popular" z filtrami czasowymi.
  • Wyświetlane są tylko repozytoria z poprawnymi plikami instalacyjnymi.
  • Ocena tematów uwzględniająca platformę, aby użytkownicy Androida/komputera widzieli najpierw odpowiednie aplikacje.
  • Odnowione wyszukiwanie z lepszym rankingiem trafności i wydajnością.

• Przeglądarka wydań i instalacja

  • Selektor wydań umożliwiający przeglądanie i instalację z dowolnego wydania, nie tylko najnowszego.
  • Pobiera wszystkie wydania każdego repozytorium.
  • Pojedyncza akcja "Zainstaluj najnowszą wersję" oraz rozwijana lista wszystkich dostępnych wydań i ich instalatorów.
  • Opcja ręcznej instalacji z automatycznym sprawdzaniem kompatybilności.

• Szczegółowy ekran informacji

  • Nazwa aplikacji, wersja, przycisk "Zainstaluj najnowszą wersję" oraz akcja udostępniania.
  • Gwiazdki, forki, otwarte zgłoszenia.
  • Wyrenderowana zawartość README ("O tej aplikacji").
  • Notatki do wydania w formacie Markdown dla dowolnego wybranego wydania.
  • Lista instalatorów z etykietami platform i rozmiarami plików.
  • Obsługa głębokich linków — otwiera szczegóły repozytorium bezpośrednio przez URL.
  • Ekran profilu dewelopera do przeglądania repozytoriów i aktywności dewelopera.

• Zarządzanie aplikacjami

  • Otwieraj, odinstalowuj i instaluj starsze wersje aplikacji bezpośrednio z GitHub Store.
  • Android: dopasowywanie architektury APK (armv7/armv8), monitorowanie pakietów i śledzenie aktualizacji.
  • Komputer (Windows/macOS/Linux): pobiera instalatory do folderu Pobrane użytkownika i otwiera je domyślnym programem obsługi.

• Ulubione repozytoria

  • Zapisuj i przeglądaj swoje ulubione repozytoria z GitHuba bezpośrednio w aplikacji.

• Sieć i wydajność

  • Dynamiczna obsługa proxy do konfigurowalnego routingu sieciowego.
  • Ulepszony system pamięci podręcznej zapewniający szybsze ładowanie i mniejsze zużycie API.

• Wieloplatformowy UX

  • Android: natywny ekran powitalny, obsługa wygasania sesji i adaptacyjna ikona.
  • Komputer: priorytetowa obsługa AppImage na Linuxie wraz z formatami DEB i RPM.
  • Zlokalizowany w 12 językach: angielski, hiszpański, francuski, japoński, koreański, polski, rosyjski, chiński, bengalski, hindi, włoski i turecki.

🔍 Jak moja aplikacja pojawia się w GitHub Store?

GitHub Store nie korzysta z żadnego prywatnego indeksowania ani ręcznych zasad kuracji. Twój projekt może pojawić się automatycznie, jeśli spełnia następujące warunki:

1. Publiczne repozytorium na GitHubie

   • Widoczność musi być ustawiona na public.

2. Pliki instalacyjne w najnowszym wydaniu

   • Najnowsze wydanie musi zawierać co najmniej jeden plik z obsługiwanym rozszerzeniem:
     • Android: .apk
     • Windows: .exe, .msi
     • macOS: .dmg, .pkg
     • Linux: .deb, .rpm, .AppImage
   • GitHub Store ignoruje automatycznie generowane archiwa kodu źródłowego (Source code (zip) / Source code (tar.gz)).

3. Wykrywalność przez wyszukiwanie / tematy

   • Repozytoria są pobierane za pośrednictwem publicznego API wyszukiwania GitHuba.
   • Tematy, język i opis pomagają w klasyfikacji:
     • Aplikacje na Androida: tematy takie jak android, mobile, apk.
     • Aplikacje desktopowe: tematy takie jak desktop, windows, linux, macos, compose-desktop, electron.
   • Posiadanie przynajmniej kilku gwiazdek zwiększa prawdopodobieństwo pojawienia się w sekcjach Trending/Hot Release/Most Popular.

Jeśli Twoje repozytorium spełnia te warunki, GitHub Store może je znaleźć przez wyszukiwanie i wyświetlić automatycznie, bez konieczności ręcznego zgłaszania.

🧭 Jak działa GitHub Store (przegląd)

1. Wyszukiwanie

   • Używa endpointu /search/repositories GitHuba z zapytaniami dostosowanymi do platformy.
   • Stosuje prostą ocenę opartą na tematach, języku i opisie.
   • Filtruje zarchiwizowane repozytoria oraz te z małą liczbą sygnałów.

2. Sprawdzanie wydań i plików

   • Dla repozytoriów-kandydatów wywołuje /repos/{owner}/{repo}/releases/latest.
   • Sprawdza tablicę assets pod kątem rozszerzeń plików specyficznych dla platformy.
   • Jeśli nie znaleziono odpowiedniego pliku, repozytorium jest wykluczane z wyników.
   • Użytkownicy mogą również przeglądać wszystkie wydania za pomocą selektora wydań.

3. Ekran szczegółów

   • Informacje o repozytorium: nazwa, właściciel, opis, gwiazdki, forki, zgłoszenia.
   • Przeglądarka wydań: nawiguj po dowolnym wydaniu z jego tagiem, datą, changelogiem i plikami.
   • README: ładowany z głównej gałęzi i renderowany jako "O tej aplikacji".
   • Link do profilu dewelopera i akcja udostępniania.
   • Dostępny przez głębokie linki do bezpośredniej nawigacji.

4. Proces instalacji

   • Gdy użytkownik kliknie "Zainstaluj najnowszą wersję" lub wybierze konkretne wydanie:
     • Wybiera najbardziej odpowiedni plik dla bieżącej platformy (z dopasowaniem architektury na Androidzie).
     • Przesyła strumieniowo pobieranie z obsługą pamięci podręcznej.
     • Deleguje do instalatora systemu operacyjnego (instalator APK na Androidzie, domyślny program obsługi na komputerze).
     • Na Androidzie rejestruje instalację w lokalnej bazie danych i używa monitorowania pakietów, aby utrzymać listę zainstalowanych aplikacji w synchronizacji.
     • Obsługuje akcje otwierania, odinstalowywania i instalowania starszych wersji zarządzanych aplikacji.

✅ Zalety / Dlaczego warto używać GitHub Store?

• Koniec z przeszukiwaniem wydań na GitHubie Zobacz tylko repozytoria, które faktycznie dystrybuują pliki binarne dla Twojej platformy.

• Wie, co zainstalowałeś Śledzi aplikacje zainstalowane przez GitHub Store (Android) i podkreśla, gdy dostępne są nowe wydania, abyś mógł je zaktualizować bez ponownego przeszukiwania GitHuba.

• Zawsze aktualne Instalacje domyślnie używają najnowszego opublikowanego wydania, z opcją przeglądania i instalowania z dowolnego wcześniejszego wydania za pomocą selektora wydań.

• Spójne doświadczenie na wszystkich platformach Ten sam interfejs i logika dla Androida i komputera, z natywnym dla platformy zachowaniem instalacyjnym.

• Open source i rozszerzalny Napisany w KMP z jasnym rozdziałem między siecią, logiką domenową i interfejsem użytkownika — łatwy do sforkowania, rozszerzenia lub dostosowania.

🔐 Certyfikat podpisu APK GitHub Store

Wszystkie oficjalne wydania GitHub Store są podpisane następującym odciskiem certyfikatu:

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

🔑 Konfiguracja GitHub OAuth

Podsumowanie

1. Utwórz aplikację GitHub OAuth
2. Skopiuj Client ID
3. Wklej go do local.properties

1 - Utwórz aplikację GitHub OAuth

Przejdź do: GitHub → Settings → Developer settings → OAuth Apps → New OAuth App

Następnie kliknij Create application.

2 - Skopiuj swój Client ID

Po utworzeniu aplikacji GitHub wyświetli:

• Client ID ← tego potrzebujesz
• Client Secret ← ❗ NIE jest wymagany w tym projekcie

3 - Dodaj go do projektu

Otwórz plik local.properties w swoim projekcie (katalog główny projektu) i dodaj:

GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE

4 - Zsynchronizuj i uruchom

Zsynchronizuj projekt i uruchom aplikację. Teraz powinieneś móc zalogować się przez GitHub.

❗ Ważne uwagi

• local.properties nie jest commitowany do Gita, więc Twój Client ID pozostaje lokalny.
• Ten projekt wymaga jedynie Client ID (nie Client Secret).
• Każdy deweloper powinien utworzyć własną aplikację OAuth na potrzeby rozwoju.

☕ Wesprzyj projekt

GitHub Store osiągnął ponad 48 000 aktywnych użytkowników i ponad 5 500 gwiazdek na GitHubie — i jest w 100% darmowy, bez reklam, bez śledzenia i bez funkcji premium.

Buduję go i utrzymuję całkowicie samodzielnie, kończąc jednocześnie szkołę średnią. Twoje wsparcie (nawet 3$) pomaga mi:

✅ Utrzymywać aplikację wolną od błędów — odpowiadać na zgłoszenia i szybko wysyłać poprawki ✅ Dodawać funkcje zgłaszane przez społeczność — implementować to, czego użytkownicy naprawdę potrzebują ✅ Utrzymywać infrastrukturę — serwery, API i koszty wdrożenia

💖 Sposoby wsparcia

Nie możesz teraz wesprzeć finansowo? Nic nie szkodzi! Możesz też pomóc:

• ⭐ Dając gwiazdkę temu repozytorium — pomaga innym odkryć GitHub Store
• 🐛 Zgłaszając błędy — ulepszasz aplikację dla wszystkich
• 📢 Udostępniając znajomym — rozpowszechniaj informacje wśród innych deweloperów
• 💬 Dołączając do naszego Discorda — Twoje opinie kształtują plan rozwoju

Każda forma wsparcia — finansowa lub nie — wiele znaczy i utrzymuje ten projekt przy życiu. Dziękuję!

⚠️ Zastrzeżenie

GitHub Store jedynie pomaga odkrywać i pobierać pliki wydań, które są już opublikowane na GitHubie przez zewnętrznych deweloperów. Zawartość, bezpieczeństwo i zachowanie tych pobrań leżą wyłącznie w gestii ich odpowiednich autorów i dystrybutorów, a nie tego projektu.

Korzystając z GitHub Store, rozumiesz i akceptujesz, że instalujesz i uruchamiasz jakiekolwiek pobrane oprogramowanie na własne ryzyko. Ten projekt nie sprawdza, nie weryfikuje ani nie gwarantuje, że jakikolwiek instalator jest bezpieczny, wolny od złośliwego oprogramowania lub odpowiedni do jakiegokolwiek konkretnego celu.

Historia gwiazdek

📄 Licencja

GitHub Store jest dystrybuowany na warunkach Licencji Apache, wersja 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.