Installazione della documentazione su computer permanentemente offline

Da R2023a

Per impostazione predefinita, quando si utilizza MATLAB^®, si accede alla documentazione del prodotto sul web. Per utilizzare la documentazione su un computer permanentemente offline, è possibile scaricare la documentazione, copiarla sul computer offline e installarla su tale computer.

Se abitualmente si lavora con MATLAB mentre si è connessi a Internet e si lavora offline solo occasionalmente, vedere Installazione della documentazione per utilizzo temporaneo offline.

Prerequisiti

Questa procedura prevede il download di un'immagine ISO (Windows^® e Linux^®) o DMG (macOS) della documentazione e il suo montaggio sul computer offline. La conoscenza di concetti informatici è consigliata, ma non necessaria.
Il computer che si utilizza per scaricare la documentazione deve disporre di una connessione a Internet.
Per scaricare la documentazione, è necessario disporre di un MathWorks^® Account. L'installazione della documentazione sul computer offline non richiede un MathWorks Account.
Sia il computer che si utilizza per scaricare la documentazione sia il computer offline devono avere più di 10 GB di spazio disponibile su disco, atto a contenere le dimensioni dell'immagine ISO o DMG della documentazione.
MATLAB deve essere già installato sul computer offline.

Download della documentazione (richiede una connessione a Internet)

Per scaricare la documentazione per la release R2025a, nell'elenco Operating Systems riportato di seguito, selezionare il sistema operativo del computer offline di destinazione. Quindi, fare clic su Download documentation.

Accedi per scaricare la documentazione

Per scaricare la documentazione per le release antecedenti alla release R2025a, vedere l'articolo di assistenza How do I download and install documentation on offline machines? (Come scaricare e installare la documentazione su macchine offline?)

Copia della documentazione su un computer offline

Copiare l'immagine ISO o DMG della documentazione scaricata sul computer offline utilizzando un supporto rimovibile o una posizione di rete condivisa. Quindi, sul computer offline, montare l'immagine ISO o DMG della documentazione utilizzando la procedura standard per la propria piattaforma.

Per ulteriori dettagli, vedere l'articolo di assistenza How do I install MathWorks products using an ISO or DMG image? (Come installare i prodotti di MathWorks utilizzando un'immagine ISO o DMG?)

Installazione della documentazione su un computer offline

Installare la documentazione sul computer offline utilizzando lo strumento della riga di comando mpm. mpm è incluso come parte dell'immagine ISO o DMG della documentazione scaricata.

Nota

Eseguire questi passaggi dalla riga di comando del proprio sistema operativo. Non eseguire questi comandi da MATLAB.

Dalla riga di comando del sistema operativo, spostarsi nella cartella dell'immagine montata che contiene il programma di installazione della documentazione.
```
cd <mountedDocImage>/bin/<arch>
```
- <mountedDocImage> è la radice dell'immagine ISO o DMG della documentazione montata.
- <arch> è la cartella dell'architettura del sistema operativo dell’immagine ISO o DMG, come win64, glnxa64, maci64 o maca64.
Installare la documentazione utilizzando il comando mpm install-doc. Specificare l'opzione --matlabroot per la cartella in cui MATLAB è installato sul computer offline. Per impostazione predefinita, mpm installa la documentazione nella cartella radice del pacchetto di supporto all'interno di MATLAB, come determinato dalla funzione matlabshared.supportpkg.getSupportPackageRoot.
Esempio Windows:
```
.\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b"
```
Esempio Linux o Mac:
```
./mpm install-doc --matlabroot=/home/<username>/matlab
```
Per utilizzare la documentazione in una posizione personalizzata, specificare inoltre il percorso completo di questa posizione utilizzando l'opzione --destination. Utilizzare questa opzione quando si desidera:
- Installare la documentazione su un'unità di rete in modo che tutti gli utenti possano accedere alla stessa versione.
- Installare la documentazione in una posizione condivisa su dei computer a cui accedono più utenti. Questo scenario è valido solo per le piattaforme Linux e Mac, dove - per impostazione predefinita - la documentazione viene installata in una cartella specifica dell'utente. Su Windows, la documentazione viene installata per impostazione predefinita in un percorso condiviso.
Esempio Windows:
```
.\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b" --destination="Z:\Shared\MATLAB Doc"
```
Esempio Linux o Mac:
```
./mpm install-doc --matlabroot=/home/<username>/matlab --destination=/usr/local/share/matlab-doc
```
Smontare l'immagine ISO o DMG della documentazione. Se occorre recuperare lo spazio su disco, cancellare l'immagine.

Configurazione di MATLAB per l'utilizzo della documentazione installata

Aggiornare le impostazioni di MATLAB in modo che MATLAB apra la documentazione installata anziché la documentazione web. Per ciascuna installazione di MATLAB che utilizzerà la documentazione:

Aprire MATLAB e inserire al prompt dei comandi:

s=settings, s.matlab.help.DocLocation.PersonalValue='INSTALLED';

Se la documentazione è stata installata in una posizione personalizzata, aggiornare la radice della documentazione in modo che MATLAB punti a tale posizione. <custom/doc/install/folder> è il percorso della documentazione specificato nell'opzione --destination di mpm install-doc.
```
docroot('<custom/doc/install/folder>/help')
```
Opzionalmente, aggiungere i precedenti comandi di MATLAB al file startup.m o matlabrc.m in modo che vengano eseguiti ogni volta che viene avviato MATLAB. Per ulteriori dettagli sull'utilizzo dei file di avvio di MATLAB, vedere Startup Options in MATLAB Startup File.
Riavviare MATLAB.

Verifica dell'installazione locale

Verificare che la documentazione si apra localmente. Al prompt dei comandi di MATLAB, inserire: doc

Nella pagina del browser che si apre, controllare l'indirizzo dell'URL.

Se l'URL punta a un indirizzo IP locale e a un numero di porta (ad esempio, http://127.0.0.1:12345), significa che MATLAB sta accedendo alla documentazione installata localmente.
Se l'URL punta a un indirizzo web (ad esempio, https://www.mathworks.com/help/...), significa che MATLAB sta ancora accedendo alla documentazione web. Aggiornare MATLAB per puntare alla documentazione installata localmente, come descritto nella sezione Configurazione di MATLAB per l'utilizzo della documentazione installata.

Aggiornamento della documentazione su un computer offline

Ripetere le procedure precedenti per aggiornare la documentazione installata dopo l'aggiunta o la rimozione di prodotti, o per installare la documentazione più recente.