Back to Github Store

GitHub Store

docs/README-RU.md

1.8.021.8 KB
Original Source
<div align="center"> </br> </div> <div align="center">

GitHub Store

</div> </br> <p align="center"> </br> </br> <a href="https://github.com/OpenHub-Store/GitHub-Store/stargazers"> </a> </br> </br> <a href="https://github.com/OpenHub-Store/GitHub-Store/releases/latest"> </a> <a href="https://f-droid.org/packages/zed.rainxch.githubstore"> </a> </br> </br> <p align="center"> <a href="https://trendshift.io/repositories/22313" target="_blank"></a> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store" target="_blank"> </a> </p> </p> <div align="center">

🗺️ Обзор проекта

GitHub Store — это кросс-платформенный магазин приложений для релизов GitHub, созданный для упрощения поиска и установки программного обеспечения с открытым исходным кодом. Он автоматически обнаруживает устанавливаемые бинарные файлы (APK, EXE, DMG, AppImage, DEB, RPM), предлагает установку в один клик, отслеживает обновления и представляет информацию о репозиториях в чистом интерфейсе в стиле магазина приложений.

Создан на базе Kotlin Multiplatform и Compose Multiplatform для платформ Android и Desktop.

</div>

[!CAUTION] Свободный и открытый Android под угрозой. Google превратит Android в закрытую платформу, ограничивая вашу основную свободу устанавливать приложения по своему выбору. Заявите о своей позиции – keepandroidopen.org.

<p align="middle"> </p> <div align="center">

📔 Вики и ресурсы

Обратитесь к Вики GitHub Store для часто задаваемых вопросов и полезной информации

🌐 Веб-сайт: github-store.org 💬 Discord: Присоединяйтесь к сообществу 📜 Политика конфиденциальности: github-store.org/privacy-policy

</div>
<div align="center">

📋 Правовая информация

GitHub Store — это независимый проект с открытым исходным кодом, не связанный с GitHub, Inc.
Название описывает функциональность приложения (обнаружение релизов GitHub) и не подразумевает владения товарным знаком.
GitHub® является зарегистрированным товарным знаком GitHub, Inc.

</div>
<p align="center">

🔃 Скачать

</p> <p align="center"> <a href="https://github.com/OpenHub-Store/GitHub-Store/releases"> </a> <a href="https://f-droid.org/en/packages/zed.rainxch.githubstore/"> </a> </p> <p align="center"> <a href="https://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/OpenHub-Store/GitHub-Store/"> </a> <a href="https://github-store.org/app?repo=OpenHub-Store/GitHub-Store"> </a> </p>

[!IMPORTANT] Пользователи macOS: Вы можете увидеть предупреждение о том, что Apple не может проверить GitHub Store. Это происходит потому, что приложение распространяется за пределами App Store и ещё не нотаризовано. Разрешите его через Системные настройки → Конфиденциальность и безопасность → Всё равно открыть.


<p align="center">

🏆 Упоминания в СМИ

</p> <p align="center"> <a href="https://www.youtube.com/@howtomen"> </a> </br> <strong>HowToMen:</strong> <a href="https://www.youtube.com/watch?v=7favc9MDedQ">Top 20 лучших приложений для Android 2026</a> | <a href="https://www.youtube.com/watch?v=VR-MEwPDw4k">Top 12 магазинов приложений лучше Google Play Store</a> </br> <strong>HelloGitHub:</strong> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store">Избранный проект</a> </p>

🚀 Возможности

  • Умное обнаружение

    • Разделы на главном экране для проектов "Trending", "Hot Release" и "Most Popular" с фильтрами по времени.
    • Отображаются только репозитории с действительными устанавливаемыми файлами.
    • Оценка тем с учётом платформы, чтобы пользователи Android/десктопа видели релевантные приложения первыми.
    • Обновлённый поиск с улучшенным ранжированием по релевантности и производительности.
  • Браузер релизов и установка

    • Селектор релизов для просмотра и установки из любого релиза, а не только последнего.
    • Получает все релизы каждого репозитория.
    • Действие «Установить последнюю версию» в один клик, а также выпадающий список всех доступных релизов и их установщиков.
    • Возможность ручной установки с автоматическими проверками совместимости.
  • Подробный экран деталей

    • Название приложения, версия и кнопка «Поделиться».
    • Звёзды, форки, открытые issues.
    • Отрендеренное содержимое README («О приложении»).
    • Примечания к релизу в формате Markdown для любого выбранного релиза.
    • Список установщиков с метками платформ и размерами файлов.
    • Поддержка глубоких ссылок — открывайте детали репозитория напрямую через URL.
    • Экран профиля разработчика для просмотра репозиториев и активности разработчика.
  • Управление приложениями

    • Открывайте, удаляйте и откатывайте версии установленных приложений прямо из GitHub Store.
    • Android: совпадение архитектуры APK (armv7/armv8), мониторинг пакетов и отслеживание обновлений.
    • Десктоп (Windows/macOS/Linux): загрузка установщиков в папку «Загрузки» пользователя и открытие с помощью обработчика по умолчанию.
  • Избранные репозитории

    • Сохраняйте и просматривайте ваши избранные репозитории GitHub из приложения.
  • Сеть и производительность

    • Поддержка динамического прокси для настраиваемой маршрутизации сети.
    • Улучшенная система кэширования для более быстрой загрузки и снижения использования API.

🔍 Как моё приложение появится в GitHub Store?

GitHub Store не использует никакой частной индексации или ручных правил курирования.
Ваш проект может появиться автоматически, если он соответствует следующим условиям:

  1. Публичный репозиторий на GitHub

    • Видимость должна быть public.
  2. Устанавливаемые файлы в последнем релизе

    • Последний релиз должен содержать как минимум один файл с совместимым расширением:
      • Android: .apk
      • Windows: .exe, .msi
      • macOS: .dmg, .pkg
      • Linux: .deb, .rpm, .AppImage
    • GitHub Store игнорирует автоматически сгенерированные архивы исходного кода (Source code (zip) / Source code (tar.gz)).
  3. Обнаружимость через поиск / topics

    • Репозитории получаются через публичный API поиска GitHub.
    • Topics, язык и описание помогают в ранжировании:
      • Приложения для Android: topics вроде android, mobile, apk.
      • Десктопные приложения: topics вроде desktop, windows, linux, macos, compose-desktop, electron.
    • Наличие хотя бы нескольких звёзд увеличивает вероятность появления в разделах Trending/Hot Release/Most Popular.

Если ваш репозиторий соответствует этим условиям, GitHub Store может найти его через поиск и отобразить автоматически, без необходимости ручной подачи заявки.


✅ Преимущества / Зачем использовать GitHub Store?

  • Больше не нужно копаться в релизах GitHub Вы видите только репозитории, которые действительно распространяют бинарные файлы для вашей платформы.

  • Знает, что вы установили Отслеживает приложения, установленные через GitHub Store (Android), и уведомляет о наличии новых релизов, чтобы вы могли обновиться без повторного поиска на GitHub.

  • Всегда актуально Установки по умолчанию используют последний опубликованный релиз, с возможностью просмотра и установки из любого предыдущего релиза через селектор релизов.

  • Открытый исходный код и расширяемость
    Написан на KMP с чётким разделением сети, доменной логики и пользовательского интерфейса — легко форкнуть, расширить или адаптировать.


🔐 Сертификат подписи APK GitHub Store

Все официальные релизы 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
<details> <summary><strong>Показать полное руководство по настройке</strong></summary>

1 - Создать GitHub OAuth App

Перейдите в: GitHub → Settings → Developer settings → OAuth Apps → New OAuth App

ПолеЗначение
Application nameЛюбое на ваш выбор (напр. GitHub Store Dev)
Homepage URLhttps://github.com/username/repo_name
Authorization callback URLgithubstore://callback

Затем нажмите Create application.

2 - Скопировать Client ID

После создания приложения GitHub покажет:

  • Client ID ← это то, что вам нужно
  • Client Secret ← ❗ НЕ требуется для этого проекта

3 - Добавить в проект

Откройте файл local.properties вашего проекта (корень проекта) и добавьте:

properties
GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE

4 - Синхронизировать и запустить

Синхронизируйте проект и запустите приложение. Теперь вы сможете войти через GitHub.

❗ Важные замечания

  • local.properties не загружается в Git, поэтому ваш Client ID остаётся локальным.
  • Этот проект требует только Client ID (не Client Secret).
  • Каждый разработчик должен создать собственное OAuth-приложение для разработки.
</details>

☕ Поддержать проект

GitHub Store создан и поддерживается старшеклассником. Ваша поддержка помогает ему:

Поддерживать приложение без ошибок — отвечать на issues и быстро выпускать исправления
Добавлять функции по запросам сообщества — реализовывать то, что действительно нужно пользователям

💖 Способы поддержки

<a href="https://www.buymeacoffee.com/rainxchzed"> </a> <a href="https://github.com/sponsors/rainxchzed"> </a>

Не можете поддержать финансово прямо сейчас? Ничего страшного! Вы также можете помочь:

  • Поставив звезду этому репозиторию — помогает другим открыть для себя GitHub Store
  • 🐛 Сообщая об ошибках — улучшает приложение для всех
  • 📢 Поделившись с друзьями — расскажите другим разработчикам и знакомым!
  • 💬 Присоединившись к нашему Discord — ваши отзывы формируют план развития

Любая форма поддержки — финансовая или нет — значит многое и помогает проекту жить. Спасибо!


⚠️ Отказ от ответственности

GitHub Store лишь помогает вам находить и скачивать файлы релизов, которые уже опубликованы на GitHub сторонними разработчиками.
Содержание, безопасность и поведение этих загрузок являются исключительной ответственностью их авторов и распространителей, а не данного проекта.

Используя GitHub Store, вы понимаете и соглашаетесь с тем, что устанавливаете и запускаете любое загруженное программное обеспечение на свой страх и риск.
Данный проект не проверяет, не подтверждает и не гарантирует, что какой-либо установщик является безопасным, свободным от вредоносного ПО или подходящим для какой-либо конкретной цели.


История звёзд

<a href="https://www.star-history.com/#OpenHub-Store/GitHub-Store&type=timeline&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=OpenHub-Store/GitHub-Store&type=timeline&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=OpenHub-Store/GitHub-Store&type=timeline&legend=top-left" /> </picture> </a>

📄 Лицензия

GitHub Store распространяется под Лицензией Apache, Версия 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.