Appium을 사용하여 디바이스와 상호 작용 - AWS Device Farm
Appium 세션으로 테스트하기 위해 앱 사용Appium 엔드포인트 사용 방법

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Appium을 사용하여 디바이스와 상호 작용

원격 액세스 세션을 생성하면 디바이스를 Appium 테스트에 사용할 수 있습니다. 원격 액세스 세션의 전체 기간 동안 사용하는 클라이언트에 대한 제한 없이 디바이스에서 원하는 수만큼 Appium 세션을 실행할 수 있습니다. 예를 들어 IDE의 로컬 Appium 코드를 사용하여 테스트를 실행한 다음 Appium Inspector로 전환하여 발생하는 문제를 해결할 수 있습니다. 세션은 최대 150분 동안 지속될 수 있지만 5분 이상 활동이 없는 경우(대화형 콘솔 또는 Appium 엔드포인트를 통해) 세션 시간이 초과됩니다.

Appium 세션으로 테스트하기 위해 앱 사용

Device Farm을 사용하면 앱(들)을 원격 액세스 세션 생성 요청의 일부로 사용하거나 원격 액세스 세션 자체 중에 앱을 설치할 수 있습니다. 이러한 앱은 테스트 중인 디바이스에 자동으로 설치되며 모든 Appium 세션 요청에 대한 기본 기능으로 주입됩니다. 원격 액세스 세션을 생성할 때 기본적으로 모든 후속 Appium 세션의 appium:app 기능으로 사용되는 앱 ARN과 appium:otherApps 기능으로 사용되는 보조 앱 ARNs을 전달할 수 있는 옵션이 있습니다.

예를 들어 앱을 앱com.aws.devicefarm.sample으로 사용하고 보조 앱 com.aws.devicefarm.other.sample 중 하나로 사용하여 원격 액세스 세션을 생성하는 경우 Appium 세션을 생성하면 다음과 유사한 기능을 갖게 됩니다.

{
    "value":
    {
        "sessionId": "abcdef123456-1234-5678-abcd-abcdef123456",
        "capabilities":
        {
            "app": "/tmp/com.aws.devicefarm.sample.apk",
            "otherApps": "[\"/tmp/com.aws.devicefarm.other.sample.apk\"]",
            ...
        }
    }
}

세션 중에 추가 앱을 설치할 수 있습니다(콘솔 내에서 또는 InstallToRemoteAccessSession API를 사용하여). 이렇게 하면 이전에 appium:app 기능으로 사용된 기존 앱이 재정의됩니다. 이전에 사용한 앱의 패키지 이름이 다르면 디바이스에 남아 appium:otherApps 기능의 일부로 사용됩니다.

예를 들어, 처음에 원격 액세스 세션을 생성할 com.aws.devicefarm.sample 때 앱을 사용한 다음 세션 com.aws.devicefarm.other.sample 중에 라는 새 앱을 설치하는 경우 Appium 세션에는 다음과 유사한 기능이 있습니다.

{
    "value":
    {
        "sessionId": "abcdef123456-1234-5678-abcd-abcdef123456",
        "capabilities":
        {
            "app": "/tmp/com.aws.devicefarm.other.sample.apk",
            "otherApps": "[\"/tmp/com.aws.devicefarm.sample.apk\"]",
            ...
        }
    }
}

원하는 경우 앱 이름을 사용하여 앱의 기능을 명시적으로 지정할 수 있습니다(각각 Android 및 iOS의 appium:appPackage 또는 appium:bundleId 기능 사용).

웹 앱을 테스트하는 경우 Appium 세션 생성 요청의 browserName 기능을 지정합니다. Chrome 브라우저는 모든 Android 디바이스에서 사용할 수 있으며 Safari 브라우저는 모든 iOS 디바이스에서 사용할 수 있습니다.

Device Farm은 원격 액세스 세션 appium:app 중에에 원격 URL 또는 로컬 파일 시스템 경로를 전달하는 기능을 지원하지 않습니다. 앱을 Device Farm에 업로드하고 대신 세션에 포함합니다.

참고

원격 액세스 세션의 일부로 앱을 자동으로 업로드하는 방법에 대한 자세한 내용은 앱 업로드 자동화를 참조하세요.

Appium 엔드포인트 사용 방법

다음은 콘솔 AWS CLI, 및 AWS SDKs. 이 단계에는 다양한 Appium 클라이언트 테스트 프레임워크를 사용하여 테스트 실행을 시작하는 방법이 포함됩니다.

Console

  1. 웹 브라우저에서 원격 액세스 세션 페이지를 엽니다.

    원격 액세스 세션 페이지

  2. Appium Inspector를 사용하여 세션을 실행하려면 다음을 수행합니다.

    1. Appium 세션 설정 버튼을 클릭합니다.

    2. Appium Inspector를 사용하여 세션을 시작하는 방법에 대한 페이지의 지침을 따릅니다.

  3. 로컬 IDE에서 Appium 테스트를 실행하려면 다음을 수행합니다.

    1. Appium 엔드포인트 URL 텍스트 옆에 있는 "복사" 아이콘을 클릭합니다.

    2. 현재 원격 주소 또는 명령 실행기를 지정할 때마다이 URL을 로컬 Appium 코드에 붙여넣습니다. 언어별 예제를 보려면이 예제 창의 탭 중 하나를 클릭하여 원하는 언어를 선택하십시오.

AWS CLI

먼저 최신 버전을 다운로드하고 설치하여 AWS CLI 버전이 up-to-date 버전인지 확인합니다.

중요

Appium 엔드포인트 필드는 AWS CLI의 이전 버전에서는 사용할 수 없습니다.

세션이 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

$ aws devicefarm get-remote-access-session \
    --arn "arn:aws:devicefarm:us-west-2:123456789876:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000"

그러면 다음과 같은 출력이 표시됩니다.

{
    "remoteAccessSession": {
        "arn": "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000",
        "name": "Google Pixel 8",
        "status": "RUNNING",
        "endpoints": {
            "remoteDriverEndpoint": "https://devicefarm-interactive-global.us-west-2.api.aws/remote-endpoint/ABCD1234...",
        ...
}

현재 원격 주소 또는 명령 실행기를 지정할 때마다 로컬 Appium 코드에서이 URL을 사용할 수 있습니다. 언어별 예제를 보려면이 예제 창의 탭 중 하나를 클릭하여 원하는 언어를 선택하십시오.

명령줄에서 엔드포인트와 직접 상호 작용하는 방법의 예를 보려면 명령줄 도구 curl을 사용하여 WebDriver 엔드포인트를 직접 호출할 수 있습니다.

$ curl "https://devicefarm-interactive-global.us-west-2.api.aws/remote-endpoint/ABCD1234.../status"

그러면 다음과 같은 출력이 표시됩니다.

{
    "value":
    {
        "ready": true,
        "message": "The server is ready to accept new connections",
        "build":
        {
            "version": "2.5.1"
        }
    }
}
Python

세션이 시작되고 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

# To get the URL
import sys
import boto3
from botocore.exceptions import ClientError

def get_appium_endpoint() -> str:
    session_arn = "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000"
    device_farm_client = boto3.client("devicefarm", region_name="us-west-2")

    try:
        resp = device_farm_client.get_remote_access_session(arn=session_arn)
    except ClientError as exc:
        sys.exit(f"Failed to call Device Farm: {exc}")

    remote_access_session = resp.get("remoteAccessSession", {})
    endpoints = remote_access_session.get("endpoints", {})
    endpoint = endpoints.get("remoteDriverEndpoint")

    if not endpoint:
        sys.exit("Device Farm response did not include endpoints.remoteDriverEndpoint")

    return endpoint

# To use the URL
from appium import webdriver
from appium.options.android import UiAutomator2Options

opts = UiAutomator2Options()
driver = webdriver.Remote(get_appium_endpoint(), options=opts)
# ...
driver.quit()
Java

참고:이 예제에서는 AWS SDK for Java v2를 사용하며 JDK 버전 11 이상과 호환됩니다.

세션이 시작되고 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

// To get the URL
import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.devicefarm.DeviceFarmClient;
import software.amazon.awssdk.services.devicefarm.model.GetRemoteAccessSessionRequest;
import software.amazon.awssdk.services.devicefarm.model.GetRemoteAccessSessionResponse;

public class AppiumEndpointBuilder {
    public static String getAppiumEndpoint() throws Exception {
        String session_arn = "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000";

        try (DeviceFarmClient client = DeviceFarmClient.builder()
                .region(Region.US_WEST_2)
                .credentialsProvider(DefaultCredentialsProvider.create())
                .build()) {

            GetRemoteAccessSessionResponse resp = client.getRemoteAccessSession(
                    GetRemoteAccessSessionRequest.builder().arn(session_arn).build()
            );

            String endpoint = resp.remoteAccessSession().endpoints().remoteDriverEndpoint();
            if (endpoint == null || endpoint.isEmpty()) {
                throw new IllegalStateException("remoteDriverEndpoint missing from response");
            }
            return endpoint;
        }
    }
}

// To use the URL
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.options.UiAutomator2Options;

import java.net.URL;

public class ExampleTest {
    public static void main(String[] args) throws Exception {
        String endpoint = AppiumEndpointBuilder.getAppiumEndpoint();
        UiAutomator2Options options = new UiAutomator2Options();
        AndroidDriver driver = new AndroidDriver(new URL(endpoint), options);

        try {
            // ... your test ...
        } finally {
            driver.quit();
        }
    }
}
JavaScript

참고:이 예제에서는 AWS SDK for JavaScript v3 및 WebdriverIO v8+ using Node 18+를 사용합니다.

세션이 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

// To get the URL
import { DeviceFarmClient, GetRemoteAccessSessionCommand } from "@aws-sdk/client-device-farm";

export async function getAppiumEndpoint() {
  const sessionArn = "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000";

  const client = new DeviceFarmClient({ region: "us-west-2" });
  const resp = await client.send(new GetRemoteAccessSessionCommand({ arn: sessionArn }));

  const endpoint = resp?.remoteAccessSession?.endpoints?.remoteDriverEndpoint;
  if (!endpoint) throw new Error("remoteDriverEndpoint missing from response");
  return endpoint;
}

// To use the URL with WebdriverIO
import { remote } from "webdriverio";

(async () => {
  const endpoint = await getAppiumEndpoint();
  const u = new URL(endpoint);

  const driver = await remote({
    protocol: u.protocol.replace(":", ""),
    hostname: u.hostname,
    port: u.port ? Number(u.port) : (u.protocol === "https:" ? 443 : 80),
    path: u.pathname + u.search,
    capabilities: {
      platformName: "Android",
      "appium:automationName": "UiAutomator2",
      // ...other caps...
    },
  });

  try {
    // ... your test ...
  } finally {
    await driver.deleteSession();
  }
})();
C#

세션이 시작되고 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

// To get the URL
using System;
using System.Threading.Tasks;
using Amazon;
using Amazon.DeviceFarm;
using Amazon.DeviceFarm.Model;

public static class AppiumEndpointBuilder
{
    public static async Task<string> GetAppiumEndpointAsync()
    {
        var sessionArn = "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000";

        var config = new AmazonDeviceFarmConfig
        {
            RegionEndpoint = RegionEndpoint.USWest2
        };
        using var client = new AmazonDeviceFarmClient(config);

        var resp = await client.GetRemoteAccessSessionAsync(new GetRemoteAccessSessionRequest { Arn = sessionArn });
        var endpoint = resp?.RemoteAccessSession?.Endpoints?.RemoteDriverEndpoint;

        if (string.IsNullOrWhiteSpace(endpoint))
            throw new InvalidOperationException("RemoteDriverEndpoint missing from response");

        return endpoint;
    }
}

// To use the URL
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Android;

class Example
{
    static async Task Main()
    {
        var endpoint = await AppiumEndpointBuilder.GetAppiumEndpointAsync();

        var options = new AppiumOptions();
        options.PlatformName = "Android";
        options.AutomationName = "UiAutomator2";

        using var driver = new AndroidDriver(new Uri(endpoint), options);
        try
        {
            // ... your test ...
        }
        finally
        {
            driver.Quit();
        }
    }
}
Ruby

세션이 시작되고 실행되면 GetRemoteAccessSession API 호출에 대한 응답remoteDriverEndpoint에서 라는 필드를 통해 Appium 엔드포인트 URL을 사용할 수 있습니다.

# To get the URL
require 'aws-sdk-devicefarm'

def get_appium_endpoint
  session_arn = "arn:aws:devicefarm:us-west-2:111122223333:session:abcdef123456-1234-5678-abcd-abcdef123456/abcdef123456-1234-5678-abcd-abcdef123456/00000"

  client = Aws::DeviceFarm::Client.new(region: 'us-west-2')
  resp = client.get_remote_access_session(arn: session_arn)
  endpoint = resp.remote_access_session.endpoints.remote_driver_endpoint
  raise "remote_driver_endpoint missing from response" if endpoint.nil? || endpoint.empty?
  endpoint
end

# To use the URL
require 'appium_lib_core'

endpoint = get_appium_endpoint
opts = {
  server_url: endpoint,
  capabilities: {
    'platformName' => 'Android',
    'appium:automationName' => 'UiAutomator2'
  }
}

driver = Appium::Core.for(opts).start_driver
begin
  # ... your test ...
ensure
  driver.quit
end