Installa Nexus Studio ed esegui il tuo primo test

Sette passaggi ti portano dall'inizio della prova a un'esecuzione programmata. Le sezioni successive forniscono i dettagli: scarica il programma di installazione, verificalo, attiva questa macchina, esegui un test. I test vengono eseguiti sulla tua macchina; l'unica comunicazione verso l'esterno è la verifica della licenza.

I tuoi primi 7 minuti

Dall'inizio della prova a un'esecuzione programmata, nell'ordine previsto da Studio. La configurazione iniziale scarica i browser, per diverse centinaia di MB, quindi il tempo necessario dipende dalla tua connessione.

1. Avvia la prova e installa. Accedi al tuo account, accetta i Termini e avvia la prova di 30 giorni, senza carta di credito. Scarica il programma di installazione, verifica il suo SHA-256, eseguilo e attiva questa macchina con la tua chiave di licenza. Poi apri o crea una cartella per l'area di lavoro e scegli Installa tutto nella guida alla configurazione (dettagli).
2. Registra il tuo primo test (Nexus Recorder). In Patrol, apri la scheda Nexus Recorder, inserisci l'URL da registrare e un nome per il test, quindi scegli Avvia registrazione. Esegui il tuo percorso facendo clic nella finestra del browser che si apre, poi chiudi la finestra o scegli Interrompi & salva. Studio scrive il file del test nella tua area di lavoro. Anche lo strumento di scrittura con IA e Test Adapter creano test, se preferisci descriverne uno o importarne uno che hai già.
3. Fai una prova nella sandbox (3 esecuzioni). Una volta salvata la registrazione, scegli Esegui nella sandbox, con browser visibile. Un'esecuzione nella sandbox non scrive nulla nelle evidenze o nella cronologia e ciascuna delle tre prove usa un browser diverso. La scheda In attesa di uscire dalla sandbox di Patrol le conta da 0/3 a 3/3, poi il test passa a Pronti per la prima esecuzione reale. I test API non hanno una sandbox: vengono eseguiti realmente al primo clic.
4. Prima esecuzione reale. Nella scheda Esegui pattuglia, seleziona il test, lascia sandbox deselezionato e scegli Esegui pattuglia per davvero. Un'esecuzione reale scrive nelle evidenze e nella cronologia. I test Playwright vengono eseguiti su Chromium, Firefox e WebKit, mentre i test Selenium su Chromium e Firefox.
5. Leggi il verdetto. Patrol colora ogni test in base al suo stato in ciascun browser, e la barra di esecuzione sopra l'editor indica a parole cosa sta facendo ogni browser. Lo stato corrisponde a uno dei 14 verdetti: SECURE indica un test superato al primo tentativo, FLAKY un test superato solo dopo un nuovo tentativo, BREACHED un problema reale e TIMEOUT una mancata risposta entro il tempo previsto, che non dimostra la presenza di un malfunzionamento.
6. Apri le prove. Nella barra dei menu, scegli Visualizza, poi Archivio prove. Ogni record si apre sulle schede Resoconto, Metadati, Telemetria e Log grezzo. Contrassegna un errore come Bug reale o Falso allarme, indicando un motivo: il primo verdetto avvia la catena di custodia e Verifica indica il primo record modificato.
7. Pianifica l'esecuzione (Monitoraggio o CI/CD). Monitoraggio, nella scheda Esegui pattugliamento, riesegue una selezione a intervalli programmati, senza supervisione: da ogni 5 minuti a ogni 24 ore, oppure una sola volta in una data specifica. Richiede che la macchina su cui è installato Studio sia accesa e invia avvisi su Telegram o Slack, se li colleghi, solo quando uno stato cambia. Per una pipeline, scegli Esegui, poi Ambienti & CI/CD: la schermata genera il file per GitHub Actions o GitLab CI (Esegui i tuoi test da CI/CD). Una macchina che esegue il motore in CI è una macchina attivata e viene conteggiata nel tuo piano.

Requisiti di sistema

Su Windows 11 x64 con 16 GB di RAM, il programma di installazione fornisce tutto ciò che serve alla macchina per eseguire i test Playwright. Ogni riga contrassegnata come Facoltativo è necessaria solo per la funzionalità indicata e viene verificata nella schermata di configurazione di Studio.

Scarica il programma di installazione

1. Apri Download e scegli Scarica per Windows. La pagina mostra la versione, la data di rilascio, le dimensioni e l'hash SHA-256. Lo stesso programma di installazione è disponibile nella sezione Download del tuo account.
2. Non hai ancora una licenza? Accedi al tuo account, con la tua email o con Google, e nella Panoramica accetta i Termini e avvia la prova di 30 giorni. I 30 giorni decorrono solo dall'attivazione di Studio.

Verifica il file scaricato

L'hash SHA-256 nella pagina Download è l'impronta digitale del programma di installazione che abbiamo pubblicato. Confrontalo con quello del file scaricato prima di eseguirlo. In PowerShell, dalla cartella che contiene il file:

(Get-FileHash -Algorithm SHA256 ".\<installer file name>").Hash -eq "<SHA-256 from the Download page>"

True indica che il file è quello che abbiamo pubblicato; le maiuscole non contano. False indica che non lo è: eliminalo, scaricalo di nuovo e non eseguirlo.

Windows SmartScreen potrebbe bloccare un nuovo programma di installazione con il messaggio “PC protetto da Windows”. Prosegui solo se la verifica restituisce True: scegli Ulteriori informazioni, poi Esegui comunque.

Attiva questa macchina

1. Esegui il programma di installazione, poi apri Nexus Studio.
2. Copia la tua chiave di licenza. Nel tuo account viene mostrata una sola volta: subito dopo l'avvio della prova, oppure quando scegli Ottieni chiave di licenza in Licenza & macchine con un piano a pagamento. Ne conserviamo solo un hash, quindi se la perdi, rigenerala.
3. Finché non viene attivato, Studio si apre sulla schermata Licenza. Incolla la chiave nel campo della chiave di licenza e scegli Attiva. La chiave inizia con nxs_live_ ed è lunga 61 caratteri; gli spazi e le interruzioni di riga aggiunti durante la copia vengono ignorati.
4. Lo stato indica Attiva. Per una licenza di prova, i 30 giorni iniziano ora.

La chiave viene inviata una sola volta, per attivare questa macchina, e Studio non la conserva. Da quel momento Studio verifica autonomamente la propria licenza. La stessa schermata mostra, in Cosa viene inviato da questa macchina, la richiesta esatta che verrà inviata alla prossima verifica (cosa contiene).

Se l'attivazione viene rifiutata, il messaggio ne indica il motivo: la chiave non è valida, tutte le macchine previste dal piano sono in uso, questa macchina ha già usufruito di una prova, la licenza non è in regola con i pagamenti oppure il server delle licenze non è raggiungibile.

Apri un'area di lavoro ed esegui la configurazione

Questa parte avviene sulla tua macchina e noi non ne vediamo nulla: né il test, né il risultato.

1. Apri una cartella. I tuoi test e le relative evidenze si trovano in un'unica cartella di lavoro. Scegli Nuova cartella e Crea qui, oppure Apri esistente per una cartella che è già un'area di lavoro.
2. Configurazione. L'area di lavoro installa i propri pacchetti e browser una sola volta, con npm install e playwright install. Nella guida alla configurazione, Installa tutto esegue i passaggi ancora mancanti, uno dopo l'altro, e Continua si sblocca quando ogni riga obbligatoria è pronta. Questa operazione richiede la rete; in seguito l'area di lavoro funziona offline, a parte la verifica della licenza. adb serve solo per i telefoni Android reali.
3. Poi il test vero e proprio. Crealo, provalo, eseguilo davvero e leggi il verdetto: passaggi da 2 a 6 di I tuoi primi 7 minuti.

La panoramica di Studio mostra tutte le schermate.

Aggiornamenti

Gli aggiornamenti non sono mai automatici: nulla viene scaricato o installato finché non scegli Aggiorna ora. A quel punto basta un clic.

1. Quando viene pubblicata una nuova versione, Studio mostra una riga sotto la barra dei menu: Nexus Studio e la versione, è disponibile, con Aggiorna ora e Più tardi. L'avviso arriva firmato, insieme alla verifica della licenza; Studio non mostra nulla per gli aggiornamenti che non può verificare.
2. Nulla viene scaricato finché non scegli Aggiorna ora. Studio scarica quindi il programma di installazione tramite HTTPS da downloads.sentinel-nexusstudio.com e ne confronta lo SHA-256 con quello nell'avviso firmato. L'avviso non richiede una connessione dedicata e il download è l'unica connessione oltre al controllo della licenza.
3. Se la verifica riesce, Studio si chiude, la nuova versione si installa senza domande a cui rispondere, mostrando solo una barra di avanzamento, e Studio si riapre. Se la verifica non riesce, il file viene eliminato, non viene installato nulla e la riga indica il motivo e propone Riprova.
4. Dopo l'aggiornamento, la copia del motore in ogni area di lavoro si aggiorna automaticamente alla nuova versione. I tuoi test, le evidenze e le impostazioni rimangono invariati.

Dove eseguirlo

Studio funziona sul tuo PC Windows 11 e non serve altro.

• Il tuo PC. Installa Studio, apri un'area di lavoro e avvia l'esecuzione. Le esecuzioni pianificate avvengono solo mentre il PC è attivo.
• Un mini PC, facoltativo. Una macchina dedicata con Windows 11 che rimane accesa, per i test di regressione notturni e le esecuzioni pianificate senza occupare una postazione di lavoro. Watch rispetta la pianificazione e le evidenze restano sul disco della macchina.
• Un ambiente di esecuzione per ogni area di lavoro. Ogni area di lavoro sceglie dove il motore esegue le proprie suite, nella schermata Docker di Studio: su questa macchina; in Docker su questa macchina, nel contenitore di esecuzione sullo stesso disco; oppure su un VPS tramite SSH, che esegue la stessa immagine del contenitore. Due applicazioni da testare in due aree di lavoro possono usare due ambienti di esecuzione diversi. Nessuna delle tre opzioni è obbligatoria e per passare dall'una all'altra basta un'impostazione. Studio rimane sempre su Windows.
• Un VPS esegue Ubuntu 24.04 LTS con Docker Engine e Compose v2, ed è accessibile tramite autenticazione con chiave SSH. Le evidenze rimangono lì finché non le scarichi. Verifica la propria licenza e conta come una macchina del tuo piano: vedi piani e macchine.
• I telefoni Android reali si collegano via USB alla macchina su cui è in esecuzione Studio, con il debug USB attivo; Dispositivi & mobile include una guida per collegare il primo. Le esecuzioni sui telefoni, le suite Selenium e Python e i test di caos sull'infrastruttura vengono sempre eseguiti sulla macchina di Studio.

Watch, il pianificatore, funziona solo sulla macchina su cui si trova Studio, con l'ambiente di esecuzione dell'area di lavoro impostato su Local. Per pianificare le esecuzioni su un VPS, usa il tuo sistema CI: Esegui i tuoi test da CI/CD.

Mantieni il controllo della tua infrastruttura ti aiuta a scegliere tra queste configurazioni e confronta le tue macchine con una piattaforma QA nel cloud e un server a noleggio: dove risiedono le evidenze, chi può accedervi e quali sono i costi.

Come fa Nexus Studio a testare localhost senza un tunnel?

Il tuo sistema QA dedicato. Nessun tunnel, nessun URL di staging esposto, nessun dato di test che esce dalla tua rete. Funziona su Windows 11, Ubuntu 24.04 LTS, Docker o SSH. BASE_URL indirizza la suite alla tua app su localhost o su un URL di staging privato, così com'è.

• Un server di sviluppo lasciato in esecuzione dopo i test.

  NEXUS_APP_START avvia la tua app prima di ogni esecuzione e la arresta insieme al suo intero albero dei processi quando l'esecuzione termina, fallisce o viene interrotta, anche con Ctrl+C.

• Un'esecuzione riuscita su un'app che non si è mai avviata.

  L'esecuzione attende che l'URL di disponibilità risponda con un codice di stato inferiore a 500, verificandolo ogni 0.5 s. Se l'app non riesce ad avviarsi, l'esecuzione non parte: CONFIG_ERROR APP_DID_NOT_START, con le ultime 40 righe di log dell'app.

• Una seconda copia di un'app già in esecuzione.

  NEXUS_APP_REUSE=true usa un'app che risponde già e la lascia in esecuzione; false interrompe l'esecuzione se a quell'indirizzo risponde qualcos'altro.

• Un risultato che nessuno riesce a ricondurre a una build.

  Ogni esecuzione registra la versione nel package.json della tua app e il commit git sottoposto a test.

• Docker e SSH.

  Con Docker l'app continua a essere eseguita su questa macchina e il contenitore raggiunge un BASE_URL su localhost tramite host.docker.internal. Tramite SSH si avvia sull'host remoto.

Un programma e i suoi argomenti, senza shell: npm run dev, pnpm dev o node server.js. nexus app check, Provala nello Studio, la avvia, attende e la arresta. Il log completo rimane in evidence/run-context/.