Skip to content

README-PL.md

Latest commit

 

History

History
313 lines (230 loc) · 15.2 KB

README-PL.md

File metadata and controls

313 lines (230 loc) · 15.2 KB
Raw
Project logo

GitHub Store

License Kotlin Platforms Release GitHub stars Compose Multiplatform Koin

Русский | English | Español | Français | 한국어 | 中文 | 日本語 | Polski

GitHub Store to wieloplatformowy „play store” dla realasów repozytoriów GitHub. Prezentuje repozytoria, które udostępniają rzeczywiste, instalowalne pliki binarne, i umożliwia ich instalowanie, śledzenie oraz aktualizowanie na różnych platformach – wszystko z jednego miejsca.

Zrzuty ekranu znajdziesz w folderze screenshots/.

✨ Czym jest GitHub Store?

GitHub Store to aplikacja Kotlin Multiplatform (Android + Desktop), która przekształca wydania GitHub w przejrzystą aplikację w stylu sklepu z aplikacjami:

  • Wyświetla tylko repozytoria, które faktycznie zawierają pliki instalacyjne (APK, EXE, DMG, AppImage, DEB, RPM itp.).
  • Wykrywa platformę użytkownika i wyświetla odpowiedni instalator.
  • Zawsze instaluje najnowszą opublikowaną wersję, podświetla listę zmian i może powiadamiać o dostępności aktualizacji zainstalowanych aplikacji (w systemie Android).
  • Wyświetla przejrzysty ekran szczegółów zawierający statystyki, plik README i informacje o deweloperze.

FAQ

🔃 Download

Important

W systemie macOS może pojawić się ostrzeżenie, że firma Apple nie może zweryfikować, czy sklep GitHub Store jest wolny od złośliwego oprogramowania. Dzieje się tak, ponieważ aplikacja jest dystrybuowana poza sklepem App Store i nie została jeszcze poświadczona notarialnie. Można ją zezwolić poprzez Ustawienia systemowe → Prywatność i bezpieczeństwo → Otwórz mimo to.

🏆 Featured In

Featured by HowToMen

🚀 Funkcjonalności

  • Inteligentne wyszukiwanie

  • Sekcje główne dla projektów „Trendy”, „Ostatnio zaktualizowane” i „Nowe” z filtrami czasowymi.

  • Wyświetlane są tylko repozytoria z ważnymi zasobami, które można zainstalować.

  • Ocena tematów uwzględniająca platformę, dzięki czemu użytkownicy Androida/komputerów stacjonarnych najpierw widzą odpowiednie aplikacje.

  • Instalacje najnowszych wersji

  • Pobiera /releases/latest dla każdego repozytorium.

  • Wyświetla tylko zasoby z najnowszej wersji.

  • Pojedyncza akcja „Zainstaluj najnowszą wersję” oraz rozwijana lista wszystkich instalatorów dla tej wersji.

  • Ekran z bogatymi szczegółami

  • Nazwa aplikacji, wersja, przycisk „Zainstaluj najnowszą wersję”.

  • Gwiazdki, rozwidlenia, otwarte zgłoszenia.

  • Wyświetlana treść pliku README („O tej aplikacji”).

  • Najnowsze informacje o wydaniu (treść) z formatowaniem markdown.

  • Lista instalatorów z oznaczeniami platform i rozmiarami plików.

  • Wieloplatformowy interfejs użytkownika

  • Android: otwiera pliki APK do pobrania za pomocą instalatora pakietów, śledzi instalacje w lokalnej bazie danych i wyświetla je na dedykowanym ekranie aplikacji wraz ze wskaźnikami aktualizacji.

  • Komputery stacjonarne (Windows/macOS/Linux): pobiera instalatory do folderu „Pobrane” użytkownika i otwiera je za pomocą domyślnego programu obsługującego; brak ukrytych lokalizacji tymczasowych.

  • Wygląd i motywy

  • Projekt Material 3 z komponentami Material 3 Expressive na wszystkich platformach.

  • Obsługa dynamicznych kolorów Material You w systemie Android, jeśli jest dostępna.

  • Opcjonalny tryb AMOLED black dla ciemnego motywu na urządzeniach OLED.

  • Bezpieczeństwo i kontrola (Android)

  • Opcjonalne logowanie do GitHub za pośrednictwem przepływu urządzeń OAuth w celu uzyskania wyższych limitów szybkości przy minimalnym zakresie.

  • Akcja „Otwórz w AppManager” umożliwiająca sprawdzenie uprawnień i trackerów pliku APK przed instalacją.

🔍 W jaki sposób moja aplikacja pojawia się w sklepie GitHub Store?

Sklep GitHub nie stosuje żadnych prywatnych zasad indeksowania ani ręcznej selekcji.
Twój projekt może pojawić się automatycznie, jeśli spełnia następujące warunki:

  1. Publiczne repozytorium na GitHub
  • Widoczność musi być ustawiona jako „publiczna”.
  1. Co najmniej jedna opublikowana wersja
  • Utworzona za pomocą GitHub Releases (nie tylko tagów).
  • Najnowsza wersja nie może być wersją roboczą ani przedpremierową.
  1. Zasoby, które można zainstalować w najnowszej wersji
  • Najnowsza wersja musi zawierać co najmniej jeden plik zasobów z obsługiwanym rozszerzeniem:
  • Android: .apk
  • Windows: .exe, .msi
  • macOS: .dmg, .pkg
  • Linux: .deb, .rpm, .AppImage
    • Sklep GitHub ignoruje automatycznie generowane artefakty źródłowe GitHub (Kod źródłowy (zip) / Kod źródłowy (tar.gz)).
  1. Wyszukiwalne według wyszukiwania / tematów
  • Repozytoria są pobierane za pośrednictwem publicznego interfejsu API wyszukiwania GitHub.
    • Temat, język i opis pomagają w rankingu:
  • Aplikacje na Androida: tematy takie jak android, mobile, apk.
  • Aplikacje desktopowe: tematy takie jak desktop, windows, linux, macos, compose-desktop, electron.
    • Posiadanie co najmniej kilku gwiazdek zwiększa prawdopodobieństwo pojawienia się w sekcjach Popularne/Zaktualizowane/Nowe.

Jeśli Twoje repozytorium spełnia te warunki, GitHub Store może je znaleźć za pomocą wyszukiwania i wyświetlić automatycznie — bez konieczności ręcznego przesyłania.

🧭 Jak działa GitHub Store (ogólny opis)

  1. Wyszukiwanie
  • Wykorzystuje punkt końcowy GitHub /search/repositories z zapytaniami dostosowanymi do platformy.
  • Stosuje prostą punktację opartą na tematach, języku i opisie.
  • Filtruje zarchiwizowane repozytoria i te z zbyt małą liczbą sygnałów.
  1. Sprawdzenie wydania + zasobów
  • W przypadku repozytoriów kandydujących wywołuje /repos/{owner}/{repo}/releases/latest.
  • Sprawdza tablicę assets pod kątem rozszerzeń plików specyficznych dla platformy.
  • Jeśli nie znaleziono odpowiednich zasobów, repozytorium jest wykluczane z wyników.
  1. Ekran szczegółów
  • Informacje o repozytorium: nazwa, właściciel, opis, gwiazdki, rozwidlenia, problemy.
  • Najnowsza wersja: tag, data publikacji, treść (lista zmian), zasoby.
  • README: ładowane z domyślnej gałęzi i renderowane jako „O tej aplikacji”.
  1. Przebieg instalacji
    • Gdy użytkownik kliknie „Zainstaluj najnowszą wersję”:
  • Wybiera zasób najlepiej pasujący do bieżącej platformy.
  • Rozpoczyna pobieranie.
  • Przekazuje do instalatora systemu operacyjnego (instalator APK w systemie Android, domyślny program obsługi na komputerze stacjonarnym).
  • W systemie Android rejestruje instalację w lokalnej bazie danych i korzysta z monitorowania pakietów, aby zsynchronizować listę zainstalowanych elementów.

⚙️ Tech stack

✅ Zalety / Dlaczego warto korzystać z GitHub Store?

  • Koniec z przeszukiwaniem wydań GitHub Wyświetlane są tylko repozytoria, które faktycznie zawierają pliki binarne dla Twojej platformy.

  • Wiedza o zainstalowanych aplikacjach Śledzi aplikacje zainstalowane za pośrednictwem GitHub Store (Android) i zaznacza dostępność nowych wydań, dzięki czemu można je aktualizować bez konieczności ponownego przeszukiwania GitHub.

  • Zawsze najnowsza wersja
    Instalacje pochodzą z najnowszej opublikowanej wersji; widoczny dziennik zmian odzwierciedla dokładnie to, co instalujesz.

  • Jednolite doświadczenie na wszystkich platformach
    Ten sam interfejs użytkownika i logika dla Androida i komputerów stacjonarnych, z natywnym dla platformy zachowaniem instalacyjnym.

  • Otwarta platforma i możliwość rozbudowy
    Napisany w KMP z wyraźnym rozdzieleniem sieci, logiki domeny i interfejsu użytkownika — łatwy do rozwidlenia, rozbudowy lub dostosowania.

💖 Wesprzyj ten projekt

Sklep GitHub jest bezpłatny i zawsze taki pozostanie. Jeśli okazał się dla Ciebie pomocny, rozważ:

Sponsor on GitHub Buy Me a Coffee

Twoje wsparcie pomaga mi:

  • Utrzymywać aplikację dla ponad 20 tysięcy użytkowników
  • Tworzyć nowe funkcje
  • Tworzyć więcej bezpłatnych narzędzi dla programistów

Możesz też oznaczyć repozytorium gwiazdką i udostępnić je innym! ⭐

Star History

Star History Chart

🔑 Konfiguracja

Sklep GitHub Store wykorzystuje aplikację GitHub OAuth do uwierzytelniania i izolacji limitów API.

  1. Utwórz aplikację GitHub OAuth w GitHub → Ustawienia → Ustawienia programisty → Aplikacje OAuth.
  2. Ustaw adres URL wywołania zwrotnego na githubstore://callback (Nie jest to zbyt ważne).
  3. Skopiuj identyfikator klienta z aplikacji OAuth.
  4. W pliku local.properties swojego projektu dodaj:

⚠️ Disclaimer

Sklep GitHub Store pomaga jedynie w wyszukiwaniu i pobieraniu zasobów, które zostały już opublikowane w serwisie GitHub przez zewnętrznych programistów.
Za zawartość, bezpieczeństwo i działanie tych plików do pobrania odpowiedzialność ponoszą wyłącznie ich autorzy i dystrybutorzy, a nie niniejszy projekt.

Korzystając z GithubStore, użytkownik rozumie i zgadza się, że instaluje i uruchamia wszelkie pobrane oprogramowanie na własne ryzyko.
Projekt ten nie weryfikuje, nie potwierdza ani nie gwarantuje, że jakikolwiek instalator jest bezpieczny, wolny od złośliwego oprogramowania lub odpowiedni do określonego celu.

Stats

Alt

📄 License

GitHub Store will be released under the 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.