Получение доступа к командной строке из XCTest – Портал дистанционного обучения Swiftbook

Обучение

Курсы и профессии

Сообщество

О нас

SwiftBook —ресурс №1 по обучению программированию на Swift в России и странах СНГ

Политика конфиденциальности Пользовательское соглашение

Туториалы и статьи / Получение доступа к командной строке из XCTest

Войти

Регистрация

Туториалы

01 февраля 2023

ПД

Туториалы

01 февраля 2023

Получение доступа к командной строке из XCTest

Содержание

Что это такое?
И это полезно, потому что…?
Круто, в чём прикол?
Хорошо, покажи мне, как это сделать!
Это работает на реальных устройствах?
Хорошо, это работает на CI?
Бесконечно благодарен!

Предварительный просмотр

Что это такое?

Командная строка — довольно мощный инструмент. Его можно использовать для автоматизации множества вещей здесь и там. Очевидно, речь идёт не только о сценариях Shell, из него можно запустить и любой другой инструмент. Но использовать его напрямую не всегда возможно.

XCTest, например, работает внутри песочницы, это означает, что вы буквально не можете даже высунуть нос из коробки. Ну, почти. Давайте обойдём это ограничение и узнаем, как получить доступ к командной строке из тестов.

И это полезно, потому что…?

1. Это открывает совершенно новый мир функций, связанных с симулятором, которые доступны через simctl и idb, но еще не через XCTest API. Например:

тестирование push-уведомлений;
автоматизация сценариев, связанных с местоположением;
видеозапись неудачных испытаний.

2. Это открывает возможность создать и использовать автономный фиктивный сервер, который может полностью заменить реальный бэкэнд для целей тестирования.
3. Это позволяет выполнять любые действия пользовательского интерфейса macOS через Applescript из ваших XCTests.
4. Это дает возможность автоматизировать действия, связанные с Интернетом, с помощью playwright или selenium вместо открытия Safari на iOS.
5. Это предлагает довольно гибкий способ экспортировать всё, что вы хотите, из теста на хост-компьютер (скриншоты, макеты, тестовые данные и т. д.).
5. И многое другое.

Круто, в чём прикол?

Нам необходимо создать HTTP-сервер, который будет прослушивать запросы. Затем мы можем отправить запрос из XCTest на сервер и запустить всё, что захотим. Сервер может даже вернуть выходные данные обратно в XCTest, если это необходимо.

Хорошо, покажи мне, как это сделать!

Пример сценария

GIVEN we have a server running on localhost: 4567 (у нас есть сервер, работающий на локальном хосте: 4567)
AND we sent a request to /terminal endpoint from XCTest with the desired command (и мы отправили запрос на конечную точку /terminal из XCTest с необходимой командой)
WHEN server receives the request (сервер получает запрос)
AND server executes the command (и сервер выполняет команду)
THEN server returns the result back to XCTest (тогда сервер возвращает результат обратно в XCTest)
AND XCTest verifies the result (и XCTest проверяет результат)

Проходим сценарий

1. Выберите любой веб-фреймворк по вашему выбору (они почти все одинаковы для нашего варианта использования)

{
"js": "express", // https://github.com/expressjs/express
"rb": "sinatra", // https://github.com/sinatra/sinatra
"py": "flask", // https://github.com/pallets/flask
"go": "gin", // https://github.com/gin-gonic/gin
"..": "..." // ...
}

2. Создайте HTTP-сервер (в качестве примера я взял { "js": "express" })

Командная строка:

npm install express
touch server.js
open server.js

server.js:

const process = require("child_process");
const express = require("express");
const app = express();
const port = 4567;

app.use(express.json());

app.listen(port);

app.post("/terminal", (req, res) => {
const output = exec(req.body.command, req.query.async).toString("utf8").trim();
res.send(output);
});

function exec(command, async) {
if (async === "true") {
return process.exec(command);
} else {
return process.execSync(command);
}
}

3. Запустите сервер

node server.js

4. Создайте тестовый файл

import XCTest

class SampleUITests: XCTestCase {
let host = "http://localhost"
let port: UInt16 = 4567

func testMacintoshVersion() {
let macOsVersion = exec("sw_vers -productVersion")
XCTAssertEqual(macOsVersion.split(separator: ".").first, "12")
}

func exec(_ command: String, async: Bool = false) -> String {
let urlString = "\(host):\(port)/terminal?async=\(async)"
guard let url = URL(string: urlString) else { return "" }

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: ["command": command], options: [])
var output = ""

if async {
// Do not wait for the command to complete
URLSession.shared.dataTask(with: request).resume()
} else {
// Wait for the command to complete
let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let data = data, let string = String(data: data, encoding: .utf8) {
output = string
semaphore.signal()
}
}
task.resume()
semaphore.wait()
}
return output
}
}

5. Запустите тест

6. Настройте скрипты под свои нужды и наслаждайтесь взломом!

Это работает на реальных устройствах?

Эмм, да, но не из коробки. Вам необходимо убедиться, что сервер доступен с устройства.
Для этого есть два варианта:

Подключайтесь к Wi-Fi и отправляйте запросы на сервер, используя IP-адрес рабочего стола вместо локального хоста.
Предоставьте доступ к вашему локальному серверу в Интернете (например, через ngrok).