Back to Github Store

GitHub Store

docs/README-IT.md

1.8.016.3 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">

🗺️ Panoramica del Progetto

GitHub Store è uno store di applicazioni multipiattaforma per le release di GitHub, progettato per semplificare la scoperta e l'installazione di software open source. Rileva automaticamente i binari installabili (APK, EXE, DMG, AppImage, DEB, RPM), offre l'installazione con un solo clic, traccia gli aggiornamenti e presenta le informazioni sui repository in un'interfaccia pulita in stile app store.

Sviluppato con Kotlin Multiplatform e Compose Multiplatform per le piattaforme Android e Desktop.

</div>

[!CAUTION] Android libero e open source è sotto minaccia. Google trasformerà Android in una piattaforma chiusa, limitando la tua libertà fondamentale di installare le app che preferisci. Fai sentire la tua voce – keepandroidopen.org.

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

📔 Wiki e Risorse

Consulta la Wiki di GitHub Store per le FAQ e informazioni utili

🌐 Sito web: github-store.org 💬 Discord: Unisciti alla community 📜 Informativa sulla privacy: github-store.org/privacy-policy

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

📋 Note Legali

GitHub Store è un progetto open source indipendente, non affiliato a GitHub, Inc.
Il nome descrive la funzionalità dell'app (scoperta delle release di GitHub) e non implica alcuna proprietà di marchio.
GitHub® è un marchio registrato di GitHub, Inc.

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

🔃 Download

</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] Utenti macOS: Potresti vedere un avviso che indica che Apple non riesce a verificare GitHub Store. Ciò accade perché l'app è distribuita al di fuori dell'App Store e non è ancora notarizzata. Consentila tramite Impostazioni di Sistema → Privacy e Sicurezza → Apri comunque.


<p align="center">

🏆 In Evidenza Su

</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 Migliori App Android 2026</a> | <a href="https://www.youtube.com/watch?v=VR-MEwPDw4k">Top 12 Store di App Migliori del Google Play Store</a> </br> <strong>HelloGitHub:</strong> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store">Progetto in Evidenza</a> </p>

🚀 Funzionalità

  • Scoperta intelligente

    • Sezioni nella home per i progetti "Trending", "Hot Release" e "Most Popular" con filtri temporali.
    • Vengono mostrati solo i repository con file installabili validi.
    • Punteggio dei topic consapevole della piattaforma, così gli utenti Android/desktop vedono prima le app rilevanti.
    • Ricerca rinnovata con classificazione per pertinenza e prestazioni migliorate.
  • Browser delle release e installazioni

    • Selettore di release per sfogliare e installare da qualsiasi release, non solo l'ultima.
    • Recupera tutte le release di ogni repository.
    • Azione unica "Installa l'ultima versione", più un elenco espandibile di tutte le release disponibili e i loro installer.
    • Opzione di installazione manuale con controlli automatici di compatibilità.
  • Schermata dettagli ricca

    • Nome dell'app, versione e azione di condivisione.
    • Stelle, fork, issue aperte.
    • Contenuto del README renderizzato ("Informazioni su questa app").
    • Note di release con formattazione Markdown per qualsiasi release selezionata.
    • Elenco degli installer con etichette di piattaforma e dimensioni dei file.
    • Supporto ai deep link — apri i dettagli di un repository direttamente tramite URL.
    • Schermata del profilo sviluppatore per esplorare i repository e l'attività di uno sviluppatore.
  • Gestione delle applicazioni

    • Apri, disinstalla e declassa le app installate direttamente da GitHub Store.
    • Android: corrispondenza dell'architettura APK (armv7/armv8), monitoraggio dei pacchetti e tracciamento degli aggiornamenti.
    • Desktop (Windows/macOS/Linux): scarica gli installer nella cartella Download dell'utente e li apre con il gestore predefinito.
  • Repository preferiti

    • Salva e sfoglia i tuoi repository GitHub preferiti dall'app.
  • Rete e prestazioni

    • Supporto proxy dinamico per il routing di rete configurabile.
    • Sistema di cache migliorato per un caricamento più rapido e un minor utilizzo dell'API.

🔍 Come appare la mia app su GitHub Store?

GitHub Store non utilizza alcun sistema di indicizzazione privato né regole di curazione manuale.
Il tuo progetto può apparire automaticamente se rispetta queste condizioni:

  1. Repository pubblico su GitHub

    • La visibilità deve essere public.
  2. File installabili nell'ultima release

    • L'ultima release deve contenere almeno un file con un'estensione supportata:
      • Android: .apk
      • Windows: .exe, .msi
      • macOS: .dmg, .pkg
      • Linux: .deb, .rpm, .AppImage
    • GitHub Store ignora gli archivi del codice sorgente generati automaticamente (Source code (zip) / Source code (tar.gz)).
  3. Scopribile tramite ricerca / topic

    • I repository vengono recuperati tramite l'API di ricerca pubblica di GitHub.
    • I topic, il linguaggio e la descrizione influenzano il ranking:
      • App Android: topic come android, mobile, apk.
      • App desktop: topic come desktop, windows, linux, macos, compose-desktop, electron.
    • Avere almeno alcune stelle aumenta la probabilità di apparire nelle sezioni Trending/Hot Release/Most Popular.

Se il tuo repository soddisfa queste condizioni, GitHub Store può trovarlo tramite la ricerca e mostrarlo automaticamente — nessuna submission manuale richiesta.


✅ Vantaggi / Perché usare GitHub Store?

  • Niente più ricerche tra le release di GitHub Vedi solo i repository che distribuiscono effettivamente binari per la tua piattaforma.

  • Sa cosa hai installato Traccia le app installate tramite GitHub Store (Android) e segnala quando sono disponibili nuove release, così puoi aggiornarle senza dover tornare a cercare su GitHub.

  • Sempre aggiornato Le installazioni utilizzano per impostazione predefinita l'ultima release pubblicata, con la possibilità di sfogliare e installare qualsiasi release precedente tramite il selettore di release.

  • Open source ed estensibile
    Scritto in KMP con una netta separazione tra rete, logica di dominio e UI — facile da forkare, estendere o adattare.


🔐 Certificato di Firma APK di GitHub Store

Tutte le release ufficiali di GitHub Store sono firmate con la seguente impronta digitale del certificato:

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


🔑 Configurazione di GitHub OAuth

In sintesi

  1. Crea una GitHub OAuth App
  2. Copia il Client ID
  3. Inseriscilo in local.properties
<details> <summary><strong>Mostra la guida completa alla configurazione</strong></summary>

1 - Creare una GitHub OAuth App

Vai su: GitHub → Settings → Developer settings → OAuth Apps → New OAuth App

CampoValore
Application nameQuello che preferisci (es. GitHub Store Dev)
Homepage URLhttps://github.com/username/repo_name
Authorization callback URLgithubstore://callback

Poi clicca su Create application.

2 - Copiare il Client ID

Dopo la creazione, GitHub mostrerà:

  • Client ID ← questo è ciò di cui hai bisogno
  • Client Secret ← ❗ NON richiesto per questo progetto

3 - Aggiungerlo al progetto

Apri il file local.properties del tuo progetto (nella root) e aggiungi:

properties
GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE

4 - Sincronizzare ed eseguire

Sincronizza il progetto ed esegui l'app. Ora dovresti poter accedere con GitHub.

❗ Note importanti

  • local.properties non è incluso in Git, quindi il tuo Client ID rimane locale.
  • Questo progetto ha bisogno solo del Client ID (non del Client Secret).
  • Ogni sviluppatore dovrebbe creare la propria OAuth App per lo sviluppo.
</details>

☕ Supporta il progetto

GitHub Store è sviluppato e mantenuto da uno studente liceale. Il tuo supporto lo aiuta a:

Mantenere l'app priva di bug — rispondere alle issue e pubblicare correzioni rapidamente
Aggiungere funzionalità richieste dalla community — implementare ciò di cui gli utenti hanno davvero bisogno

💖 Come Supportare

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

Non puoi sponsorizzare in questo momento? Nessun problema! Puoi comunque aiutare:

  • Mettendo una stella a questo repository — aiuta gli altri a scoprire GitHub Store
  • 🐛 Segnalando bug — migliora l'app per tutti
  • 📢 Condividendo con gli amici — spargi la voce tra altri sviluppatori e amici!
  • 💬 Unendoti al nostro Discord — il tuo feedback plasma la roadmap

Ogni forma di supporto — finanziario o meno — significa moltissimo e mantiene vivo questo progetto. Grazie!


⚠️ Dichiarazione di Non Responsabilità

GitHub Store ti aiuta soltanto a scoprire e scaricare file di release già pubblicati su GitHub da sviluppatori terzi.
Il contenuto, la sicurezza e il comportamento di questi download sono di esclusiva responsabilità dei rispettivi autori e distributori, non di questo progetto.

Usando GitHub Store, capisci e accetti che installi ed esegui qualsiasi software scaricato a tuo rischio e pericolo.
Questo progetto non revisiona, valida né garantisce che un installer sia sicuro, privo di malware o adatto a uno scopo specifico.


Cronologia delle Stelle

<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>

📄 Licenza

GitHub Store sarà rilasciato sotto la Licenza Apache, Versione 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.