Pour Application Mobile

Integrate your WebdriverIO tests with App Percy

Before integration, you can explore App Percy's sample build tutorial for WebdriverIO. Intégrez votre suite de tests avec BrowserStack App Percy et voici un aperçu des étapes d'intégration :

Step 1: Create new app project on percy dashboard

Inscrivez-vous à Percy et créez un nouveau projet de type application. Après avoir créé le projet, vous verrez une variable d'environnement PERCY_TOKEN. Percy utilisera le PERCY_TOKEN pour savoir à quelle organisation et à quel projet télécharger les captures d'écran. Vous aurez besoin de ce PERCY_TOKEN dans les prochaines étapes.

Step 2: Set the project token as an environment variable

Exécutez la commande suivante pour définir PERCY_TOKEN comme variable d'environnement :

export PERCY_TOKEN="<your token here>"   // macOS or Linux
$Env:PERCY_TOKEN="<your token here>"    // Windows PowerShell
set PERCY_TOKEN="<your token here>"    // Windows CMD

Step 3: Install Percy packages

Installez les composants nécessaires pour établir l'environnement d'intégration pour votre suite de tests. Pour installer les dépendances, exécutez la commande suivante :

npm install --save-dev @percy/cli

Step 4: Install dependencies

Installez Percy Appium app

npm install --save-dev @percy/appium-app

Step 5: Update test script

Assurez-vous d'importer @percy/appium-app dans votre code.

Voici un exemple de test utilisant la fonction percyScreenshot. Utilisez cette fonction partout où vous devez prendre une capture d'écran.

import percyScreenshot from '@percy/appium-app';
describe('Appium webdriverio test example', function() {
  it('takes a screenshot', async () => {
    await percyScreenshot('Appium JS example');
  });
});

Nous passons les arguments requis à la méthode percyScreenshot.

Les arguments de la méthode de capture d'écran sont :

percyScreenshot(driver, name[, options])

Step 6: Run your test script

Exécutez vos tests en utilisant percy app:exec.

Si vous ne pouvez pas utiliser la commande percy app:exec ou préférez exécuter vos tests à l'aide des options d'exécution de l'IDE, vous pouvez utiliser les commandes percy app:exec:start et percy app:exec:stop. Pour en savoir plus, visitez Run Percy.

$ percy app:exec -- appium test command

Cette commande démarre Percy, crée une nouvelle build Percy, prend des captures d'écran et les télécharge vers votre projet, puis arrête Percy :

[percy] Percy has started!
[percy] Created build #1: https://percy.io/[your-project]
[percy] Snapshot taken "Appium WebdriverIO Example"
[percy] Stopping percy...
[percy] Finalized build #1: https://percy.io/[your-project]
[percy] Done!

Visit the following pages for more details:

• Integrate your WebdriverIO tests with Percy
• Environment variable page
• Integrate using BrowserStack SDK si vous utilisez BrowserStack Automate.

Resource	Description
Official docs	Documentation WebdriverIO d'App Percy
Sample build - Tutorial	Tutoriel WebdriverIO d'App Percy
Official video	Tests visuels avec App Percy
Blog	Découvrez App Percy : plateforme de tests visuels automatisés alimentée par l'IA pour les applications natives