GitHub Store

🗺️ 프로젝트 개요

GitHub Store는 오픈소스 소프트웨어의 발견과 설치를 간편하게 만들기 위해 설계된 GitHub 릴리즈 전용 크로스플랫폼 앱 스토어입니다. 설치 가능한 바이너리(APK, EXE, DMG, AppImage, DEB, RPM)를 자동으로 감지하고, 원클릭 설치를 제공하며, 업데이트를 추적하고, 리포지터리 정보를 깔끔한 앱 스토어 스타일 인터페이스로 제공합니다.

Android 및 Desktop 플랫폼을 위해 Kotlin Multiplatform과 Compose Multiplatform으로 개발되었습니다.

[!CAUTION] 자유롭고 오픈소스인 Android가 위협받고 있습니다. Google은 Android를 폐쇄적인 플랫폼으로 바꿔 원하는 앱을 설치할 수 있는 기본적인 자유를 제한하려 합니다. 목소리를 높여주세요 – keepandroidopen.org.

📔 위키 및 리소스

FAQ와 유용한 정보는 GitHub Store 위키를 확인하세요

🌐 웹사이트: 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. 최신 릴리즈의 설치 가능한 파일

   • 최신 릴리즈에 지원되는 확장자를 가진 파일이 하나 이상 포함되어야 합니다:
     • 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.