Installer Nexus Studio et exécuter votre premier test

Sept étapes suffisent pour passer d'un nouvel essai à une exécution planifiée. Les sections suivantes détaillent la procédure : téléchargez le programme d'installation, vérifiez-le, activez cette machine, lancez un test. Les tests s'exécutent sur votre machine ; le seul élément qui la quitte est la vérification de licence.

Vos 7 premières minutes

D'un nouvel essai à une exécution planifiée, dans l'ordre attendu par le Studio. La première configuration télécharge les navigateurs, soit plusieurs centaines de Mo, la durée dépend donc de votre connexion.

1. Démarrez l'essai et installez. Connectez-vous à votre compte, acceptez les Conditions et démarrez l'essai de 30 jours, sans carte. Téléchargez le programme d'installation, vérifiez son SHA-256, exécutez-le et activez cette machine avec votre clé de licence. Ouvrez ou créez ensuite un dossier d'espace de travail et choisissez Tout installer dans le guide de configuration (détails).
2. Enregistrez votre premier test (Nexus Recorder). Dans Patrol, ouvrez l'onglet Nexus Recorder, saisissez l'URL à enregistrer ainsi qu'un nom pour le test, puis choisissez Démarrer l'enregistrement. Parcourez votre flux dans la fenêtre de navigateur qui s'ouvre, puis fermez la fenêtre ou choisissez Arrêter & enregistrer. Le Studio écrit le fichier de test dans votre espace de travail. Le rédacteur IA et le Test Adapter créent également des tests, si vous préférez en décrire un ou importer un test existant.
3. Répétez dans le bac à sable (3 exécutions). Une fois l'enregistrement sauvegardé, choisissez Exécuter dans le bac à sable, avec interface. Une exécution en bac à sable n'écrit rien dans les preuves ni dans l'historique, et chacune des trois répétitions utilise un navigateur différent. La carte En attente de quitter le bac à sable de Patrol les compte de 0/3 à 3/3, puis le test passe à Prêts pour leur première véritable exécution. Les tests d'API n'ont pas de bac à sable : ils s'exécutent pour de vrai dès le premier clic.
4. Première véritable exécution. Dans l'onglet Exécuter la patrouille, choisissez le test, laissez bac à sable décoché et choisissez Exécuter la patrouille pour de vrai. Une véritable exécution écrit dans les preuves et l'historique. Les tests Playwright s'exécutent sur Chromium, Firefox et WebKit, et les tests Selenium sur Chromium et Firefox.
5. Lisez le verdict. Patrol colore chaque test selon son état dans chaque navigateur, et le bandeau d'exécution au-dessus de l'éditeur décrit textuellement ce que fait chaque navigateur. L'état correspond à l'un des 14 verdicts : SECURE a réussi de lui-même, FLAKY a réussi uniquement après une nouvelle tentative, BREACHED est une véritable anomalie, et TIMEOUT n'a jamais répondu à temps, ce qui ne constitue pas la preuve d'un dysfonctionnement.
6. Ouvrez les preuves. Dans la barre de menus, choisissez Affichage, puis Coffre-fort de preuves. Chaque enregistrement s'ouvre sur Rapport, Métadonnées, Télémétrie et Journal brut. Marquez un échec comme Véritable bogue ou Fausse alerte, avec un motif : le premier verdict initie la chaîne de traçabilité, et Vérifier nomme le premier enregistrement modifié.
7. Planifiez-le (Surveillance ou CI/CD). Surveillance, dans l'onglet Exécuter la patrouille, réexécute automatiquement une sélection selon une minuterie, sans surveillance : de toutes les 5 minutes à 24 heures, ou une fois à une date précise. Cela nécessite que la machine du Studio soit allumée, et alerte sur Telegram ou Slack, si vous les connectez, uniquement lorsqu'un état change. Pour un pipeline, choisissez Exécuter, puis Environnements & CI/CD : l'écran rédige le fichier GitHub Actions ou GitLab CI (Exécutez vos tests depuis la CI/CD). Une machine qui exécute le moteur en CI est une machine activée et compte dans votre forfait.

Configuration requise

Sur Windows 11 x64 avec 16 Go de RAM, le programme d'installation est tout ce dont cette machine a besoin pour exécuter des tests Playwright. Chaque ligne marquée Facultatif n'est requise que par la fonctionnalité qu'elle désigne, et l'écran de configuration du Studio en vérifie la présence.

Télécharger le programme d'installation

1. Ouvrez Téléchargement et choisissez Télécharger pour Windows. La page affiche la version, la date de publication, la taille et le SHA-256. Le même installateur est disponible sous Téléchargements dans votre compte.
2. Pas encore de licence ? Connectez-vous à votre compte avec votre adresse e-mail ou via Google, puis sur Aperçu acceptez les Conditions d'utilisation et commencez l'essai de 30 jours. Les 30 jours ne commencent qu'à l'activation de Studio.

Vérifier le téléchargement

Le SHA-256 affiché sur la page de téléchargement est l'empreinte de l'installateur que nous avons publié. Comparez-le avec le fichier téléchargé avant de l'exécuter. Dans PowerShell, depuis le dossier contenant le fichier :

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

True signifie que le fichier est celui que nous avons publié ; les majuscules n'ont pas d'importance. False signifie que ce n'est pas le cas : supprimez-le, téléchargez-le à nouveau et ne l'exécutez pas.

Windows SmartScreen peut bloquer un nouvel installateur avec « Windows a protégé votre PC ». Ne passez outre que si la vérification indique True : choisissez Informations complémentaires, puis Exécuter quand même.

Activer cette machine

1. Exécutez l'installateur, puis ouvrez Nexus Studio.
2. Copiez votre clé de licence. Votre compte l'affiche une seule fois : juste après le démarrage de l'essai, ou lorsque vous choisissez Get license key sous License & machines sur un plan payant. Nous ne conservons qu'un hachage de celle-ci ; si vous la perdez, régénérez-la.
3. Tant qu'elle n'est pas activée, le Studio s'ouvre sur son écran License. Collez la clé dans le champ de clé de licence et choisissez Activate. La clé commence par nxs_live_ et comporte 61 caractères ; les espaces et les sauts de ligne introduits lors de la copie sont ignorés.
4. Le statut indique Actif. Pour un essai, les 30 jours commencent maintenant.

La clé est envoyée une seule fois, pour activer cette machine, et le Studio ne la conserve pas. À partir de ce moment, le Studio confirme sa licence de manière autonome. Le même écran affiche, sous What leaves this machine, la requête exacte qu'envoie la prochaine vérification (ce qu'elle contient).

Si l'activation est refusée, le message en indique la raison : la clé n'est pas valide, tous les postes du plan sont utilisés, cet ordinateur a déjà bénéficié d'un essai, la licence n'est pas à jour de paiement ou le serveur de licences est inaccessible.

Ouvrir un espace de travail et lancer la configuration

Cette étape se déroule sur votre machine et nous ne la voyons jamais : ni le test, ni le résultat.

1. Open a folder. Vos tests et vos preuves résident dans un seul dossier d'espace de travail. Choisissez New folder et Create here, ou Open existing pour un dossier qui est déjà un espace de travail.
2. Configuration. L'espace de travail installe ses paquets et navigateurs une seule fois, avec npm install et playwright install. Dans le guide de configuration, Tout installer exécute ce qui manque encore, étape par étape, et Continuer se déverrouille lorsque chaque ligne requise est prête. Cela nécessite le réseau ; par la suite, l'espace de travail fonctionne hors ligne, à l'exception de la vérification de la licence. adb n'est nécessaire que pour les véritables téléphones Android.
3. Ensuite, le test lui-même. Créez-le, répétez-le, exécutez-le pour de vrai et lisez le verdict : étapes 2 à 6 de Vos 7 premières minutes.

La visite guidée du Studio présente chaque écran.

Mises à jour

Les mises à jour ne sont jamais automatiques : rien n'est téléchargé ni installé tant que vous ne choisissez pas Mettre à jour maintenant. Ensuite, un seul clic suffit.

1. Lorsqu'une nouvelle version est publiée, Studio affiche une ligne sous sa barre de menus : Nexus Studio et la version, est disponible, avec Mettre à jour maintenant et Plus tard. La notification arrive signée, accompagnée de la vérification de la licence ; Studio n'affiche rien pour une mise à jour qu'il ne peut pas vérifier.
2. Rien ne se télécharge tant que vous ne choisissez pas Mettre à jour maintenant. Le Studio télécharge alors le programme d'installation via HTTPS depuis downloads.sentinel-nexusstudio.com et compare son SHA-256 à l'avis signé. L'avis ne requiert aucune connexion propre, et le téléchargement est le seul en dehors de la vérification de licence.
3. Lorsque la vérification réussit, le Studio se ferme, la nouvelle version s'installe sans aucune question à laquelle répondre, avec seulement une barre de progression, et le Studio s'ouvre à nouveau. Lorsque la vérification échoue, le fichier est supprimé, rien ne s'installe, et la ligne indique pourquoi tout en proposant Réessayer.
4. Après la mise à jour, la copie du moteur au sein de chaque espace de travail s'actualise vers la nouvelle version. Vos tests, preuves et paramètres restent intacts.

Où l'exécuter

Le Studio fonctionne sur votre propre PC Windows 11, et rien d'autre n'est nécessaire.

• Votre propre PC. Installez le Studio, ouvrez un espace de travail et lancez l'exécution. Les exécutions planifiées n'ont lieu que lorsque le PC est en marche.
• Un mini PC, optionnel. Une machine Windows 11 dédiée qui reste allumée, pour les régressions nocturnes et les exécutions planifiées sans mobiliser un poste de travail. Watch maintient son planning, et les preuves restent sur son disque.
• Un environnement d'exécution par espace de travail. Chaque espace de travail choisit où le moteur exécute ses suites, depuis l'écran Docker du Studio : cette machine ; Docker sur cette machine, dans le conteneur runner sur le même disque ; ou un VPS via SSH, exécutant la même image de conteneur. Deux applications testées dans deux espaces de travail peuvent utiliser deux environnements d'exécution différents. Aucun des trois n'est obligatoire, et le changement se fait en un seul paramètre. Le Studio lui-même reste toujours sur Windows.
• Un VPS exécute Ubuntu 24.04 LTS avec Docker Engine et Compose v2, accessible par authentification par clé SSH. Les preuves y restent jusqu'à ce que vous les récupériez. Il vérifie sa propre licence et compte comme une machine de votre abonnement : voir abonnements et machines.
• Les vrais téléphones Android se connectent à la machine du Studio via USB, avec le débogage USB activé ; Devices & Mobile propose un guide pour le premier. Les exécutions sur téléphone, les suites Selenium et Python ainsi que le chaos d'infrastructure s'exécutent toujours sur la propre machine du Studio.

Watch, le planificateur, fonctionne uniquement sur la machine propre du Studio, avec l'environnement d'exécution de l'espace de travail défini sur Local. Pour planifier des exécutions sur un VPS, utilisez votre CI : Exécutez vos tests depuis CI/CD.

Maîtrisez votre infrastructure vous aide à choisir entre ces configurations et compare vos propres machines avec une plateforme QA cloud et un serveur loué : où résident les preuves, qui peut y accéder et ce que cela coûte.

Comment Nexus Studio teste-t-il localhost sans tunnel ?

Votre propre appliance QA. Aucun tunnel, aucune URL de staging exposée, aucune donnée de test ne quittant votre réseau. Fonctionne sous Windows 11, Ubuntu 24.04 LTS, Docker ou SSH. BASE_URL oriente la suite vers votre application sur localhost ou sur une URL de staging privée, telle quelle.

• Un serveur de développement laissé en cours d'exécution après les tests.

  NEXUS_APP_START démarre votre application avant chaque exécution et l'arrête avec l'ensemble de son arbre de processus lorsque l'exécution se termine, échoue ou est interrompue, Ctrl+C inclus.

• Une exécution réussie contre une application qui n'a jamais démarré.

  L'exécution attend que l'URL de disponibilité réponde, avec n'importe quel statut inférieur à 500, vérifiée toutes les 0,5 s. Si l'application ne peut pas démarrer, l'exécution ne commence jamais : CONFIG_ERROR APP_DID_NOT_START, avec ses 40 dernières lignes de journal.

• Une deuxième instance d'une application déjà en cours d'exécution.

  NEXUS_APP_REUSE=true utilise une application qui répond déjà et la laisse en cours d'exécution ; false arrête l'exécution si autre chose répond à cet endroit.

• Un résultat que personne ne peut associer à une build.

  Chaque exécution enregistre la version package.json de votre application ainsi que le commit git qu'elle a testé.

• Docker et SSH.

  Dans Docker, l'application s'exécute toujours sur cette machine et le conteneur accède à un BASE_URL localhost via host.docker.internal. Via SSH, elle démarre sur l'hôte distant.

Un seul programme et ses arguments, sans shell : npm run dev, pnpm dev ou node server.js. nexus app check, testez-le dans le Studio, le démarre, attend et l'arrête. L'intégralité du journal reste dans evidence/run-context/.