Для мобільного додатку
Integrate your WebdriverIO tests with App Percy
Before integration, you can explore App Percy's sample build tutorial for WebdriverIO. Integrate your test suite with BrowserStack App Percy and here's an overview of the integration steps:
Step 1: Створення нового проєкту додатку на панелі Percy
Sign in to Percy and create a new app type project. After you've created the project, you'll be shown a PERCY_TOKEN environment variable. Percy will use the PERCY_TOKEN to know which organisation and project to upload the screenshots to. You will need this PERCY_TOKEN in next steps.
Step 2: Встановлення токену проєкту як змінної середовища
Run the given command to set PERCY_TOKEN as an environment variable:
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: Встановлення пакетів Percy
Install the components required to establish the integration environment for your test suite. To install the dependencies, run the following command:
npm install --save-dev @percy/cli
Step 4: Встановлення залежностей
Install the Percy Appium app
npm install --save-dev @percy/appium-app
Step 5: Оновлення тестового скрипту
Make sure to import @percy/appium-app in your code.
Below is an example test using the percyScreenshot function. Use this function wherever you have to take a screenshot.
import percyScreenshot from '@percy/appium-app';
describe('Appium webdriverio test example', function() {
it('takes a screenshot', async () => {
await percyScreenshot('Appium JS example');
});
});
We are passing the required arguments.percyScreenshot method.
The screenshot method arguments are:
percyScreenshot(driver, name[, options])
Step 6: Запуск тестового скрипту
Run your tests using percy app:exec.
If you are unable to use the percy app:exec command or prefer to run your tests using IDE run options, you can use the percy app:exec:start and percy app:exec:stop commands. To learn more, visit Run Percy.
$ percy app:exec -- appium test command
This command starts Percy, create a new Percy build, takes snapshots and uploads them to your project, and stops 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 if you are using BrowserStack Automate.
| Resource | Description |
|---|---|
| Official docs | App Percy's WebdriverIO documentation |
| Sample build - Tutorial | App Percy's WebdriverIO tutorial |
| Official video | Visual Testing with App Percy |
| Blog | Meet App Percy: AI-powered automated visual testing platform for native apps |
