SizerCalculator - Installazione su macOS
=======================================

PREMESSA
--------
MetaTrader 5 per macOS e' la versione Windows eseguita tramite Wine
(wrapper ufficiale MetaQuotes) oppure tramite CrossOver / Parallels.
MQL5 non cambia: l'EA SizerCalculator e' lo stesso codice su Windows e
su macOS, e il file .ex5 compilato funziona su entrambi.

Su Mac cambia solo DOVE si trovano i file, perche' la cartella dati sta
dentro il "bottle" di Wine. Questa guida serve a quello.


METODO RAPIDO (consigliato)
---------------------------
1. Estrai lo ZIP.
2. Doppio clic su "install_macos.command".
   Lo script cerca le cartelle MQL5 dei terminali MT5 e copia:
     SizerCalculator.mq5  ->  MQL5/Experts/
     SizerCalculator.set  ->  MQL5/Presets/
3. Se macOS blocca lo script, apri il Terminale nella cartella e digita:
     chmod +x install_macos.command
   poi esegui:
     ./install_macos.command
   Alternativa: tasto destro sullo script -> Apri con -> Terminale.
4. Vai al punto "COMPILA E ATTIVA L'EA".


METODO MANUALE
--------------
1. Apri MT5 e scegli: File -> Apri cartella dati (Open Data Folder).
   Il Finder si apre sulla cartella dati corretta del terminale.

2. Copia i file:
     SizerCalculator.mq5  ->  MQL5/Experts/
     SizerCalculator.set  ->  MQL5/Presets/

3. Vai al punto "COMPILA E ATTIVA L'EA".


COMPILA E ATTIVA L'EA
---------------------
1. In MT5 premi F4: si apre MetaEditor.
2. Apri MQL5/Experts/SizerCalculator.mq5 e premi F7 (Compile).
   In basso deve comparire: 0 errors, 0 warnings.
3. Torna in MT5: Navigator -> Expert Advisors -> tasto destro -> Refresh.
4. Trascina SizerCalculator sul grafico.
5. Proprieta' dell'EA -> Load -> SizerCalculator.set -> OK.
6. Trascina le linee SL (rossa), TP1 (verde), TP2 (verde).
7. Imposta il rischio % e premi BUY o SELL.
8. Ordini pendenti: premi PENDING, trascina la linea Entry (blu), poi BUY/SELL.
   CANCEL LAST / CANCEL ALL compaiono solo in modalita' pending.


PERCORSI TIPICI SU MAC
----------------------
App ufficiale MetaQuotes (Wine):
  ~/Library/Application Support/net.metaquotes.wine.metatrader5/drive_c/
  users/<utente>/AppData/Roaming/MetaQuotes/Terminal/<ID>/MQL5

CrossOver (bottiglia "MetaTrader 5"):
  ~/Library/Application Support/CrossOver/Bottles/MetaTrader 5/drive_c/
  users/crossover/AppData/Roaming/MetaQuotes/Terminal/<ID>/MQL5

Parallels / VMware / Windows su ARM:
  stessi percorsi di Windows:
  C:\Users\<utente>\AppData\Roaming\MetaQuotes\Terminal\<ID>\MQL5

<ID> e' un codice esadecimale (es. A862924D3B0A15A1D4A25561CDA799E7):
se hai piu' terminali installati, ci sono piu' cartelle <ID>.
Usa "File -> Apri cartella dati" per capire quale e' quella giusta.


PROBLEMI COMUNI SU MAC
----------------------
- "SizerCalculator non compare nel Navigator"
  Hai copiato i file nel terminale sbagliato: controlla la cartella <ID>
  con File -> Apri cartella dati, poi Refresh nel Navigator.

- "Impossibile aprire l'app perche' proviene da uno sviluppatore non identificato"
  Tasto destro sull'app -> Apri (una volta sola).

- "L'app e' danneggiata" (Gatekeeper)
  Apri il Terminale e digita:
    xattr -dr com.apple.quarantine "/Applications/MetaTrader 5.app"

- "install_macos.command non si apre"
  Manca il permesso di esecuzione (lo ZIP da Windows lo perde):
    chmod +x install_macos.command
    ./install_macos.command
  Oppure: tasto destro -> Apri con -> Terminale.

- "install_macos.command bloccato perche' da sviluppatore non identificato"
  Il file scaricato da internet ha l'attributo di quarantena. Una volta:
    xattr -d com.apple.quarantine install_macos.command
  Oppure tasto destro -> Apri -> Apri comunque.

- Testo o pannello poco leggibile
  Dipende dal rendering di Wine, non dall'EA: prova a cambiare tema
  (DarkMode true/false) o la dimensione del carattere del grafico.

- L'EA non chiude parzialmente a TP1
  Serve un conto HEDGING. Su conti netting la chiusura parziale non e'
  supportata e lo SL viene comunque portato a break-even.


NOTE
----
- Compila sempre sul tuo terminale (F7): evita problemi di versione.
- Il TP1 non viene inviato al broker: l'ordine ha SL e TP2 (MT5 accetta
  un solo TP per ordine). A TP1 l'EA chiude la percentuale impostata e
  sposta lo SL a break-even.
- Testa sempre su conto demo prima dell'uso reale.
- Il pacchetto contiene il sorgente: nessun file eseguibile da fidarsi
  alla cieca.
