برای اپلیکیشن موبایل
ادغام تست‌های WebdriverIO خود با App Percy
قبل از ادغام، می‌توانید آموزش نمونه ساخت App Percy برای WebdriverIO را بررسی کنید. مجموعه تست خود را با BrowserStack App Percy ادغام کنید، در ادامه مروری بر مراحل ادغام آمده است:
مرحله ۱: ایجاد پروژه اپلیکیشن جدید در داشبورد Percy
به Percy وارد شوید و یک پروژه جدید از نوع اپلیکیشن ایجاد کنید. پس از ایجاد پروژه، یک متغیر محیطی PERCY_TOKEN به شما نشان داده می‌شود. Percy از PERCY_TOKEN برای شناسایی سازمان و پروژه‌ای که باید اسکرین‌شات‌ها به آن آپلود شوند استفاده می‌کند. شما به این PERCY_TOKEN در مراحل بعدی نیاز خواهید داشت.
مرحله ۲: تنظیم توکن پروژه به عنوان متغیر محیطی
دستور زیر را برای تنظیم PERCY_TOKEN به عنوان متغیر محیطی اجرا کنید:
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
مرحله ۳: نصب بسته‌های Percy
اجزای مورد نیاز برای ایجاد محیط ادغام برای مجموعه تست خود را نصب کنید. برای نصب وابستگی‌ها، دستور زیر را اجرا کنید:
npm install --save-dev @percy/cli
مرحله ۴: نصب وابستگی‌ها
Percy Appium app را نصب کنید
npm install --save-dev @percy/appium-app
مرحله ۵: به‌روزرسانی اسکریپت تست
مطمئن شوید که @percy/appium-app را در کد خود وارد کرده‌اید.
در زیر نمونه‌ای از یک تست با استفاده از تابع percyScreenshot آمده است. از این تابع هر جا که نیاز به گرفتن اسکرین‌شات دارید استفاده کنید.
import percyScreenshot from '@percy/appium-app';
describe('Appium webdriverio test example', function() {
it('takes a screenshot', async () => {
await percyScreenshot('Appium JS example');
});
});
ما آرگومان‌های مورد نیاز را به متد percyScreenshot ارسال می‌کنیم.
آرگومان‌های متد اسکرین‌شات عبارتند از:
percyScreenshot(driver, name[, options])
مرحله ۶: اجرای اسکریپت تست
تست‌های خود را با استفاده از percy app:exec اجرا کنید.
اگر نمی‌توانید از دستور percy app:exec استفاده کنید یا ترجیح می‌دهید تست‌های خود را با استفاده از گزینه‌های اجرای IDE اجرا کنید، می‌توانید از دستورات percy app:exec:start و percy app:exec:stop استفاده کنید. برای کسب اطلاعات بیشتر، به اجرای Percy مراجعه کنید.
$ percy app:exec -- appium test command
این دستور Percy را شروع می‌کند، یک ساخت جدید Percy ایجاد می‌کند، اسکرین‌شات‌ها را می‌گیرد و آن‌ها را به پروژه شما آپلود می‌کند، و سپس 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!
برای جزئیات بیشتر به صفحات زیر مراجعه کنید:
- ادغام تست‌های WebdriverIO خود با Percy
- صفحه متغیر محیطی
- ادغام با استفاده از BrowserStack SDK اگر از BrowserStack Automate استفاده می‌کنید.
| منبع | توضیحات |
|---|---|
| مستندات رسمی | مستندات WebdriverIO مربوط به App Percy |
| ساخت نمونه - آموزش | آموزش WebdriverIO مربوط به App Percy |
| ویدیوی رسمی | تست بصری با App Percy |
| بلاگ | با App Percy آشنا شوید: پلتفرم تست بصری خودکار مبتنی بر هوش مصنوعی برای اپلیکیشن‌های بومی |
