Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ const config = {
// may want to replace "en" with "zh-Hans".
i18n: {
defaultLocale: 'en',
locales: ['en', 'es', 'fr', 'de', 'nl', 'zh', 'ja', 'ru', 'ko', 'sv', 'vi'],
locales: ['en', 'es', 'fr', 'de', 'it', 'nl', 'zh', 'ja', 'ru', 'ko', 'sv', 'vi'],
},

presets: [
Expand All @@ -55,7 +55,7 @@ const config = {
'docusaurus-lunr-search',
{
// Chinese isn't supported yet
languages: ['en', 'es', 'fr', 'de', 'nl', 'ja', 'ru', 'ko', 'sv', 'vi'],
languages: ['en', 'es', 'fr', 'de', 'it', 'nl', 'ja', 'ru', 'ko', 'sv', 'vi'],
// Keep max results to 10
maxHits: 10,
indexBatchSize: 100,
Expand Down
1 change: 1 addition & 0 deletions i18n/TRANSLATION_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ The translations are organized in the `i18n` directory with separate folders for
- `de/` - German
- `es/` - Spanish
- `fr/` - French
- `it/` - Italian
- `ja/` - Japanese
- `ko/` - Korean
- `nl/` - Dutch
Expand Down
109 changes: 109 additions & 0 deletions i18n/it/docusaurus-plugin-content-docs/current/advanced/anisette.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
---
title: Server Anisette personalizzato
description: Guida sui server anisette personalizzati.
---

:::note
Qualsiasi versione di SideStore successiva alla 0.4.0 è poco propensa a causare il blocco del tuo account grazie al supporto ai server anisette v3.

Dunque, è **fortemente consigliato** utilizzare un server v3 per il normale utilizzo di SideStore, se la tua versione lo supporta.
:::

I dati Anisette sono info utilizzate dal processo di firma dell'app e necessitano di essere generate ogni volta che installi o refreshi un'app. SideStore prende queste info da un server che si finge un Mac e risponde coi dati Anisette. Nessun info sull'account è inviata al server in questo processo.

Quando tante persone usano lo stesso server Anisette (specialmente un server v1), Apple attiva un processo di sicurezza e blocca gli account che usano quel "Mac". Ecco perché consigliamo di usare un Apple ID usa e getta al posto del principale.

Il nosto team ha lavorato a migliori approcci per evitare account bloccati (con gli _anisette-v3_). Comunque, se stai usando una vecchia versione di SideStore, hostare il tuo server anisette è una buona idea per evitare il blocco dell'account. Tutto ciò è reso estremamente semplice grazie al fatto che il nostro server è open source e pronto per Docker. Ciò significa che possiamo deployare un server semplicemente con un link GitHub.

## Deploy su Render

[Render](https://render.com/) è un servizio per creare server facilmente. Supporta il caricamento di repo GitHub. Il piano gratuito è piuttosto limitato in termini di risorse, ma il server può tranquillamente funzionare senza problemi. (Sappi che è richiesta una carta di credito/debito per l'identificazione, ma è completamente gratuito)

A causa delle troppe persone che utilizzano lo stesso URL GitHub, è necessario forkare la repo Git.

1. [Registra](https://github.com/signup) il tuo account su GitHub, se non ne hai già uno.
2. [Apri](https://github.com/Dadoum/anisette-v3-server) la repo Git.
3. Clicca "Fork" in alto a destra e forka la repo nel tuo account.
4. Una volta che la repo forkata è creata, clicca il tasto verde "Code" in alto a destra e copia l'URL .git.


* Salvalo per dopo.

Una volta fatto ciò, il server Render può essere eseguito.

1. [Registrati](https://dashboard.render.com/register/) su Render.
2. Crea un [Nuovo Web Service](https://dashboard.render.com/select-repo?type=web).
3. Scorri fino a **Public Git repository** e inserisci l'URL che hai copiato prima.
4. Clicca "Continua" e compila il form:
* **Name** - Non importa
* **Region** - La più vicina a te
* **Branch** - main (default)
* **Root Directory** - lascia vuoto (default)
* **Environment** - Docker (default)
* **Instance Type** - Gratuita

5. Aspetta che il server buildi. Vedrai il seguente messaggio quando ha finito:

```
Machine requires provisioning... done !
Your service is live 🎉
```

*Se per qualche motivo la build fallisce, clicca **Manual Deploy**, poi **Deploy latest commit**.*
*If the build fails for any reason, click **Manual Deploy**, then **Deploy latest commit**.*

6. Copia il link del tuo nuovo server in alto alla pagina:

```
https://[nome-del-server].onrender.com
```

## Creare una lista personalizzata dei server anisette

Dalla release 0.5.8, SideStore usa una lista di server anisette cosicché i server ufficiali possono essere aggiunti più facilmente. Dovremo quindi fare qualche step in più per aggiungere il nostro server personalizzato senza aggiungerlo alla lista ufficiale.

Se vuoi mantenere l'opzione di utilizzare i server inclusi, segui i seguenti step:
1. Vai [qui](https://servers.sidestore.io/servers.json) per ottenere la lista attuale dei server.
2. Vai su un hosting di fiducia per pubblicare il file online. Consigliamo l'utilizzo di GitHub Pages perché è facilita un'eventuale modifica in futuro, sarà quindi il servizio di esempio per questa guida. Se hai un altro modo, adatta gli step al tuo setup.
3. Se hai già un sito GitHub Pages, salta al sesto sotto-step. Altimenti, continua con gli step seguenti:
* Crea una nuova repo GitHub o con l'icona del più (+) in alto a destra su desktop, o icona del profilo > Crea nuovo su mobile, o tramite [questa pagina](https://github.com/new).
* Dagli il nome [il tuo username GitHub].github.io, attiva il README e metti le altre impostazioni come preferisci
* Una volta creata, vai nel tab Impostazioni e vai nella sezione Pages sotto a Code and automation.
* Imposta Build and deployment sotto a Source a 'Deploy from branch'
* Se non è già selezionato, imposta il Branch a 'main'
* Ritorna al tab code e clicca su 'Add files', poi 'Upload files', poi seleziona il file 'servers.json' che hai scaricato precedentemente.
* Una volta caricato, clicca sul file e premi 'Edit'.
* Scorri fino all'ultimo server della lista e aggiungi una virgola dopo l'ultima parentesi graffa ('}') dell'ultimo server, poi aggiungi il tuo server nel formato seguente:
```
{
"name": "[qualcosa che identifichi il server]", // non è molto importante a meno che tu non condivida il server con qualcun'altro
"address": "[l'url del server]"
}
```
* Fai il commit, poi vai su https://[il tuo username GitHub].github.io/[dove hai messo il file]/servers.json. Se il file carica, allora puoi proseguire. Altrimenti, potresti dover aspettare fino a 10 minuti per far sì che il file venga caricato correttamente nel sito.

Se vuoi usare solo il tuo server, segui gli step sopra, ma anziché copiare il file servers.json ufficiale, creane uno tu con questa sintassi:
```
{
"servers": [
{
"name": "[come sopra]",
"address": "[sempre come sopra]"
}
]
}
```
e procedi normalmente.

## Usa il tuo server con SideStore

Per usare il tuo server appena creato nell'app di SideStore, procedi in questa maniera:

1. Apri la tab Impostazioni di SideStore.
2. Sorri fino a 'Server Anisette'
3. Tocca sull'url della lista e cambialo con l'URL della tua lista dei server
4. Premi 'Aggiorna Server' e seleziona il tuo server dalla lista aggiornata.

## Fatto!

Ora SideStore userà il tuo server anisette personale.
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: Sorgenti delle app
description: Guida sulle sorgenti delle app personalizzate
---

# Creare una Sorgente

SideStore è completamente compatibile con le Sorgenti di AltStore (o AltSources). La [documentazione](https://faq.altstore.io/developers/make-a-source) ufficiale di AltSource fornisce tutti i dettagli per creare la tua AltSource. Le AltSource permettono di visualizzare, installare e aggiornare facilmente tutte le tue app.

Ecco alcuni tool di terze parti consigliati che possono aiutare nella creazione di AltSource:
- Puoi usare [AltStudio](https://altstudio.app/) (WIP) per generare automaticamente un'AltSource utilizzando un'IPA! (Attenzione- Dopo aver usato AltStudio devi rimuovere i campi autogenerati marketplaceID e Build, altrimenti SideStore crederà che sia una sorgente affidabile e impedirà la sua aggiunta)
- Puoi usare [AltSource Browser](https://altsource.by.lao.sb/browse/) per visualizzare i tuoi aggiornamenti di AltSource in bozza prima di applicare i cambiamenti, permettendoti di correggere eventuali errori prima di pubblicarli.

# Distribuire la Sorgente

Puoi creare un link per aggiungere automaticamente la tua AltSource tramite questa sintassi:
```
sidestore://source?url=[url della sorgente]
```
Per più info, vedi [URL Schema](/docs/advanced/url-schema). Spesso è utile creare link all'AltSource in questo formato, per poi usare un link shortener come `tinyurl.com`. Comunque, se un utente prova a usare un link `sidestore://` senza avere SideStore installato, crasherà, quindi un po' di documentazione aiuta.

## Finito!

Ecco alcune AltSource consigliate che puoi aggiungere a SideStore: La [SideStore Community Source](https://github.com/SideStore/Community-Source), the [official AltStore Source](https://apps.altstore.io), la [LiveContainer Source](https://raw.githubusercontent.com/LiveContainer/LiveContainer/refs/heads/main/apps.json) e la [DolphiniOS Source](https://altstore.oatmealdome.me).
41 changes: 41 additions & 0 deletions i18n/it/docusaurus-plugin-content-docs/current/advanced/jit.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: Abilitare JIT
description: Tutorial su come abilitare la compilazione Just-In-Time (JIT) per app che la richiedono.
---

:::note
iOS 26 ha rotto di nuovo JIT. Un fix sarà rilasciato in StikDebug dopo il rilascio dell'iPhone 17.

Ci sono diversi metodi per abilitare JIT, come AltJIT, SideJITServer e altri. Questo tutorial copre l'uso di StikDebug (prima StikJIT), in quanto è il metodo raccomandato. Per più info, vedi la [guida ufficiale per il pairing StikDebug](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md).

Come alternativa, SideStore 0.6.2 include aggiornamente a minimuxeer, permettendo la funzionalità JIT built-in, in modo simile a StikDebug. Per usarlo, assicurati di essere connesso a StosVPN con il Wi-Fi connesso o la Modalità Aereo attiva, poi naviga in "Le mie app", tieni premuto l'app in cui vuoi abilitare JIT e tocca "abilita JIT".
:::

## Prerequisiti
* Un iDevice con iOS/iPadOS 17.4-18.6, esclusa 18.4b1. Se sei su 17.0-17.3 devi usare un metodo alternativo come [SideJITServer](https://github.com/nythepegasus/SideJITServer). Come scritto sopra, le versioni successive alla 18.6 non sono supportate al momento.

## Installazione di StikDebug nell'App Store di Apple

1. **Installa StikDebug**
Install StikDebug dall'[App Store](https://apps.apple.com/us/app/stikdebug/id6744045754).
:::note Punto a favore- la VPN di StikDebug è simile a quella di SideStore, puoi dunque usarla per installare e refreshare le app in SideStore, in modo simile a StosVPN.
:::

2. **Procedura di installazione:**
Segui la procedura standard qui sotto.

### Procedura di installazione standard:

1. **Carica il pairing file:**
Apri e chiudi StikDebug per creare la cartella dell'app su File, poi importa lo stesso **pairing file** che usi per SideStore usando idevice pair. Per più info sul processo, vedi [qui](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md).

2. **Monta il DDI:**
Apri StikDebug con il Wi-Fi, la VPN connessa e il pairing file importato, poi chiudila e riaprila. Questo monta il DDI e deve essere fatto ogni volta che riavvii il tuo iDevice.

## Per abilitare JIT:

1. **Abilita la VPN:**
Inizia aprendo StikDebug in Wi-FI o sotto Rete Dati per attivare la VPN built-in. Ora, se sei sotto Rete Dati, attiva la modalità aereo e riapri l'app con la VPN ancora attiva.

2. **Attiva JIT:**
Seleziona il bottone "Connect by App" e scegli un'app dalla lista (deve essere sideloadata con gli entitlements giusti per apparire nella lista) per attaccare un debugger e attivare la funzionalità JIT.
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: Bypass del limite delle 3 App
description: Tutorial su come installare più di 3 app tramite SideStore tramite l'exploit SparseRestore.
---

:::note

L'exploit bypass del limite delle 3 app di SparseRestore **funziona solo sulle versioni iOS/iPadOS tra la 17.0 e la 18.1 beta 4 (esclusa la 17.7.1)**. Se non sei su queste versioni non funziona, **non chiedere supporto**.

:::


## Prerequisiti
* Un iDevice con versioni supportate dall'exploit SparseRestore (vedi le note sopra).
* Almeno uno slot app libero.
* SideStore 0.5.9 o successive. Puoi trovare le ultime versioni [qui](https://github.com/SideStore/SideStore/releases).
* Per eseguire questo exploit DEVI disattivare **Trova il mio iPhone** sul tuo iDevice durante il processo. Altrimenti non funzionerà. Ecco come puoi disattivarlo:
- Apri l'app Impostazioni
- Tocca il tuo nome in alto.
- Tocca Dov'è
- Tocca Trova il mio iPhone/iPad.
- Disattiva Trova il mio Iphone/iPad.
- Potresti dover inserire la password del tuo Apple ID per confermare.

> **Nota:** Potresti non essere in grado di disattivare Trova il mio iPhone a causa della Protezione del dispositivo rubato. Disattiva Protezione del dispositivo rubato prima di disattivare Trova il mio iPhone.

## Procedimento
1. Installa SparseBox. Si può fare in vari modi, ma in questo caso installalo con SideStore. Puoi trovare l'ultima versione [qui](https://nightly.link/khanhduytran0/SparseBox/workflows/build/main/artifact.zip) (unzippa artifact.zip per avere il file .ipa).

2. Abilita "Disattiva Limite delle App" in SideStore e assicurati che SideStore sia **chiuso** (non in background), poi apri SparseBox.

3. Abilita StosVPN, seleziona il pairing file e tocca 'Bypass 3-app limit'. Dovrebbe apparire un log. Aspetta che ci sia scritto `idevicebackup2 exited with code -18` o `idevicebackup2 exited with code 2`, poi chiudi l'app. Non è necessario premere Apply.

4. Riapri SideStore e scorri in basso nelle impostazioni. Premi "cancella cache", in questo modo SideStore vedrà l'exploit.

5. Verifica che l'exploit funzioni (potresti dover installare più di un'app, in base a quanti slot liberi hai). Se mostra un errore riguardante il limite, riapri SideStore o riesegui l'exploit. Se installa l'app, congratulazion! Puoi avere più di 3 app installate nello stesso momento.

## Note
A causa di alcune limitazioni, l'exploit deve essere eseguito ogni volta che installi altre 3 app.

Se vuoi/ti serve Trova il mio iPhone per altre ragioni, puoi riattivarlo. In ogni caso, se vuoi installare o refreshare altre app, dovrai disattivarlo di nuovo.

## Alternative
Se l'exploit non funziona, o il tuo iDevice è su una versione non supportata, c'è un'alternativa per poter usare più di 3 app alla volta. [LiveContainer](https://livecontainer.github.io/), sviluppato da Duy Tran Khanh ([khanhduytran0](https://github.com/khanhduytran0)) (la stessa persona che ha sviluppato SparseBox), permette di eseguire app containerizzate anziché installarle separatamente. È anche più semplice rispetto ad utilizzare SparseRestore in alcuni casi. La pagina GitHub è raggiungibile [qui](https://github.com/khanhduytran0/LiveContainer).
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: URL Schema
description: Guida sull'url schema.
---

# URL Schema

Qui puoi trovare una lista dei diversi URL schemes che possono essere utilizzati per interagire con SideStore. Sono molto comodi perché permettono agli sviluppatori di usare un link one-click sul proprio profilo social o sito web e iOS aprirà direttamente il link in SideStore, eseguendo l'azione specificata.

La lista di cose possibili è per ora limitata all'installazione di app e sorgenti, ma verrà ampliata nel futuro per eseguire più task.

## Installa un'app hostata in remoto

```
sidestore://install?url=[download url]
```

## Aggiungi un AltSource

```
sidestore://source?url=[source url]
```
Loading