Guida per Lavorare con MQL5 Algo Forge

  1. Perché Algo Forge
  2. Autorizzazione
  3. Ricerca ed Esplorazione dei Progetti
  4. Inizia con un Progetto in MetaEditor
    • 4.1. Collegamento a un Repository Esistente
    • 4.2. Creare un Nuovo Repository
  5. Link utili

1. Perché Algo Forge

MQL5 Algo Forge è un hub online per lavorare con i progetti MQL5, completamente integrato in MetaEditor e costruito sul sistema di controllo di versione Git. Il suo scopo principale è quello di offrire agli sviluppatori di trading algoritmico gli stessi vantaggi che GitHub fornisce alla comunità open-source:

  • Controllo della Versione Affidabile
    Git memorizza la cronologia localmente, quindi i commit, il cambio di ramo e la revisione delle modifiche sono più veloci e disponibili anche offline.

  • Comoda Ramificazione e Unione (Branching and Merging)
    Creare rami separati per le idee sperimentali e unirli facilmente alla versione principale.

  • Portale Progetti Unificato
    Su forge.mql5.io è possibile visualizzare la struttura dei file, i commit, i rami, i collaboratori e le attività di ogni repository - tutto nel proprio browser, senza servizi di terze parti.

  • Social Network per Sviluppatori di Trading Algoritmico
    Seguite gli autori più influenti, unitevi ai team, discutete le modifiche direttamente nel codice e tieni traccia del contributo di ciascun collaboratore.

  • Integrazione Diretta con MetaEditor
    I comandi integrati consentono di clonare, eseguire il commit e il push senza usare la riga di comando; tutto funziona direttamente dall'editor con un solo clic.

  • Apprendimento e Condivisione delle Conoscenze
    I repository liberi consentono di studiare le soluzioni degli altri sviluppatori, di adottare le migliori pratiche e di avviare rapidamente i propri fork.

Algo Forge trasforma lo sviluppo di robot di trading da un processo di codifica solitario a un lavoro di squadra collaborativo, grazie a un'infrastruttura basata su Git, a una cronologia delle versioni trasparente e a una comunità attiva - esattamente ciò che serve per progetti di trading algoritmico su larga scala e di alta qualità.

2. Autorizzazione

È possibile accedere ad Algo Forge in due modi, ciascuno dei quali fornisce l'accesso a funzioni differenti.

2.1 Sul portale forge.mql5.io

  1. Andate su forge.mql5.io, inserite le credenziali del vostro account MQL5 e accedete.
    Il portale utilizza l’account unificato MQL5.community, quindi non sono necessari altri login. Se non avete ancora un account, create un Nome Utente, inserite la vostra e-mail e registratevi tramite Registra. Questa coppia di Nome Utente/password funzionerà per tutti i servizi MQL5, inclusi Market, VPS e Segnali.

    Assicuratevi che i cookie siano abilitati nel vostro browser - il login non funzionerà senza di essi.


  2. Dopo aver effettuato l'accesso, vedrete il vostro feed personale del progetto, che mostra la vostra attività e i repository a cui siete collegati - sia personali che condivisi. 


    Volete esplorare il lavoro di altri sviluppatori? Vai alla scheda Esplora, qui troverete i repository pubblici, i pulsanti Preferiti/Salva e Deriva (Fork), gli elenchi dei collaboratori e la cronologia dei commit - tutte le funzionalità standard di GitHub, ma per MQL5.

2.2 Autorizzazione in MetaEditor (l'ambiente di sviluppo di MetaTrader 5)

Per accedere agli stessi repository direttamente dal vostro IDE, è sufficiente collegare MetaEditor al vostro account MQL5 una volta:

  1. Aprire MetaEditor e andare su Strumenti → Opzioni → Community.
    Le credenziali devono essere inserite nella scheda MQL5.community.

  2. Immettere il Login (nome utente, non e-mail) e la Password, quindi fare clic su OK. La password viene crittografata e memorizzata localmente, in modo da non doverla reinserire ogni volta.

  3. Dopo l'autorizzazione, tutte le funzioni Git per lavorare con Algo Forge diventano disponibili direttamente in MetaEditor.


Riepilogo: Un account MQL5.community = accesso rapido sia sul sito web che in MetaEditor. Da qui, tutte le funzionalità di Git e lo sviluppo collaborativo sono disponibili fin da subito - codificare, eseguire il commit e condividere progetti senza lasciare il proprio ambiente familiare.

  1. La sezione Esplora contiene un catalogo di progetti aperti con opzioni di ordinamento e filtraggio con più parametri. Una barra di ricerca consente di trovare progetti, sviluppatori e organizzazioni.


  2. Segui (Segui/Preferiti) - ricevi notifiche su nuovi commit, problemi e rilasci.

    Uno dei principali vantaggi di Algo Forge è la possibilità di interagire attivamente con i progetti che si ritengono interessanti. 





    Segui - segui gli aggiornamenti del progetto

    • Scopo: sottoscrivere le notifiche sugli eventi del repository.

    • Se scegliete di seguire, riceverete notifiche (via e-mail o in-app) su nuovi problemi, richieste di pull, rilasci e altre attività.

    Ideale se sei attivamente coinvolto in un progetto o vuoi seguire da vicino gli aggiornamenti.


    Preferiti - per aggiungere un progetto ai preferiti o per mostrare il proprio sostegno

    • Scopo: contrassegnare un progetto come interessante o valido.

    • Cliccando su Preferiti non ci si iscrive agli aggiornamenti; è più che altro un modo per mostrare apprezzamento e aggiungere il repository ai propri preferiti.

    • I preferiti (stellina) spesso indicano la popolarità di un progetto: più stelline ci sono, più persone lo trovano utile.

    • È possibile accedere facilmente ai progetti preferiti in un secondo momento nella sezione "Repository Preferiti".




  3. La barra di ricerca accetta nomi di progetti, ticker o nomi di autori.



  4. La pagina di un progetto comprende l’albero dei file <> del Codice, grafico dei Commit, Ramificazioni, Collaboratori e Attività. 

4. Inizia con un Progetto in MetaEditor

Sul sito MQL5 Algo Forge è possibile creare un fork del progetto di un altro sviluppatore per creare la propria copia. Questo si fa tramite il pulsante Fork nella pagina del progetto. Verrà creato un nuovo repository sotto il vostro account. Per farlo, collegatevi a https://forge.mql5.io utilizzando i dati del vostro account MQL5, andate su Esplora e selezionate un progetto. Vantaggi rispetto alla semplice copia di file:


4.1 Clonazione del Progetto di un Altro Sviluppatore

Aprite il progetto che volete clonare su forge.mql5.io e fate clic su Fork. Inserisci un nome e una descrizione per il fork e salva.



In MetaEditor (utilizzando lo stesso account MQL5), eseguire il comando "Aggiorna" nel Navigatore. Il tuo fork apparirà nella cartella "Progetti Condivisi". Scaricalo da Algo Forge utilizzando Git Clone. Riceverai non solo i file del progetto, ma anche la cronologia completa dei commit e tutti i rami. Ciò significa che puoi continuare a lavorare sul fork mantenendo comunque l'intera cronologia del progetto clonato. 


Per controllare il progetto dopo la clonazione, fare clic con il tasto destro del mouse sulla cartella del progetto, aprire il menu contestuale e selezionare Git Log. Questo visualizzerà l'intera cronologia dei commit per il ramo corrente del progetto.


4.2 Creazione del Proprio Progetto in MetaEditor

È possibile creare un nuovo progetto direttamente in MetaEditor. Questo può essere un progetto privato (1), situato in qualsiasi cartella della directory MQL5, così come un progetto pubblico (2), creato nella directory 'Progetti condivisi'. La documentazione completa sulla creazione e la gestione dei progetti è disponibile nella guida online di MetaEditor, alla sezione Creazione e Gestione dei Progetti.