Zapowiedzi

WYMAGANIA

• Konto i projekt Tuist

Podczas tworzenia aplikacji możesz chcieć udostępnić ją innym, aby uzyskać opinie. Tradycyjnie, zespoły robią to poprzez tworzenie, podpisywanie i wysyłanie swoich aplikacji na platformy takie jak TestFlight firmy Apple. Proces ten może być jednak uciążliwy i powolny, zwłaszcza gdy zależy nam jedynie na szybkiej informacji zwrotnej od współpracownika lub znajomego.

Aby usprawnić ten proces, Tuist zapewnia sposób generowania i udostępniania podglądów aplikacji każdemu.

URZĄDZENIA MUSZĄ BYĆ PODPISANE

Podczas tworzenia aplikacji na urządzenie użytkownik jest obecnie odpowiedzialny za prawidłowe podpisanie aplikacji. Planujemy usprawnić to w przyszłości.

Tuist Project

tuist build App # Build the app for the simulator
tuist build App -- -destination 'generic/platform=iOS' # Build the app for the device
tuist share App

Xcode Project

xcodebuild -scheme App -project App.xcodeproj -configuration Debug # Build the app for the simulator
xcodebuild -scheme App -project App.xcodeproj -configuration Debug -destination 'generic/platform=iOS' # Build the app for the device
tuist share App --configuration Debug --platforms iOS
tuist share App.ipa # Share an existing .ipa file

Polecenie wygeneruje link, który można udostępnić każdemu, aby uruchomić aplikację - na symulatorze lub rzeczywistym urządzeniu. Wszystko, co będą musieli zrobić, to uruchomić poniższe polecenie:

tuist run {url}
tuist run --device "My iPhone" {url} # Run the app on a specific device

Podczas udostępniania pliku .ipa można pobrać aplikację bezpośrednio z urządzenia mobilnego za pomocą łącza Podgląd. Łącza do podglądów .ipa są domyślnie publiczne. W przyszłości będzie można ustawić je jako prywatne, tak aby odbiorca linku musiał uwierzytelnić się za pomocą swojego konta Tuist, aby pobrać aplikację.

tuist run umożliwia również uruchomienie najnowszego podglądu na podstawie specyfikatora, takiego jak latest, nazwy gałęzi lub określonego skrótu zatwierdzenia:

tuist run App@latest # Runs latest App preview associated with the project's default branch
tuist run App@my-feature-branch # Runs latest App preview associated with a given branch
tuist run App@00dde7f56b1b8795a26b8085a781fb3715e834be # Runs latest App preview associated with a given git commit sha

Utwory

Ścieżki pozwalają organizować podglądy w nazwane grupy. Na przykład, możesz mieć ścieżkę beta dla wewnętrznych testerów i ścieżkę nightly dla automatycznych kompilacji. Ścieżki są tworzone leniwie - wystarczy określić nazwę ścieżki podczas udostępniania, a zostanie ona utworzona automatycznie, jeśli nie istnieje.

Aby udostępnić podgląd określonej ścieżki, należy użyć opcji --track:

tuist share App --track beta
tuist share App --track nightly

Jest to przydatne dla:

• Organizowanie podglądów: Grupowanie podglądów według przeznaczenia (np. beta, nightly, internal)
• Aktualizacje w aplikacji: Tuist SDK używa ścieżek do określenia, o których aktualizacjach powiadamiać użytkowników.
• Filtrowanie: Łatwe wyszukiwanie i zarządzanie podglądami według utworów na pulpicie nawigacyjnym Tuist.

WIDOCZNOŚĆ PRZEGLĄDÓW

Tylko osoby z dostępem do organizacji, do której należy projekt, mogą uzyskać dostęp do podglądu. Planujemy dodać obsługę wygasających linków.

Aplikacja Tuist macOS

Tuist

Download

Aby jeszcze bardziej ułatwić uruchamianie Tuist Previews, opracowaliśmy aplikację Tuist na pasek menu macOS. Zamiast uruchamiać Previews za pomocą Tuist CLI, można pobrać aplikację na macOS. Aplikację można również zainstalować, uruchamiając brew install --cask tuist/tuist/tuist.

Po kliknięciu przycisku "Uruchom" na stronie podglądu, aplikacja macOS automatycznie uruchomi się na aktualnie wybranym urządzeniu.

WYMAGANIA

Musisz mieć zainstalowany lokalnie Xcode i korzystać z systemu macOS 14 lub nowszego.

Aplikacja Tuist iOS

Tuist

Podobnie jak aplikacja na macOS, aplikacje Tuist na iOS usprawniają dostęp do podglądów i ich uruchamianie.

Komentarze do pull/merge requestów {#pullmerge-request-comments}.

WYMAGANA INTEGRACJA Z PLATFORMĄ GIT

Aby uzyskać automatyczne komentarze do pull/merge requestów, zintegruj swój

zdalny projekt z platformąGit.

Testowanie nowych funkcji powinno być częścią każdego przeglądu kodu. Jednak konieczność tworzenia aplikacji lokalnie zwiększa niepotrzebne tarcia, często prowadząc do tego, że programiści w ogóle pomijają testowanie funkcjonalności na swoich urządzeniach. Ale co by było, gdyby każde żądanie ściągnięcia zawierało link do kompilacji, która automatycznie uruchamiałaby aplikację na urządzeniu wybranym w aplikacji Tuist macOS?

Po połączeniu projektu Tuist z platformą Git, taką jak GitHub, dodaj tuist share MyApp do przepływu pracy CI. Następnie Tuist opublikuje link do podglądu bezpośrednio w żądaniach ściągnięcia:

Powiadomienia o aktualizacjach w aplikacji {#in-app-update-notifications}.

Zestaw Tuist SDK umożliwia aplikacji wykrywanie, kiedy dostępna jest nowsza wersja podglądu i powiadamianie o tym użytkowników. Jest to przydatne do utrzymywania testerów w najnowszej wersji.

Zestaw SDK sprawdza aktualizacje w ramach tej samej ścieżki podglądu. Po udostępnieniu podglądu z wyraźną ścieżką za pomocą --track, SDK będzie szukać aktualizacji na tej ścieżce. Jeśli nie określono ścieżki, gałąź git jest używana jako ścieżka - więc podgląd zbudowany z gałęzi main powiadomi tylko o nowszych podglądach również zbudowanych z main.

Instalacja

Dodaj Tuist SDK jako zależność pakietu Swift:

.package(url: "https://github.com/tuist/sdk", .upToNextMajor(from: "0.1.0"))

Monitorowanie aktualizacji {#sdk-monitor-updates}.

Użyj monitorPreviewUpdates, aby okresowo sprawdzać dostępność nowych wersji podglądu:

import TuistSDK

struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .task {
                    TuistSDK(
                        fullHandle: "myorg/myapp",
                        apiKey: "your-api-key"
                    )
                    .monitorPreviewUpdates()
                }
        }
    }
}

Pojedyncze sprawdzenie aktualizacji {#sdk-single-check}.

Do ręcznego sprawdzania aktualizacji:

let sdk = TuistSDK(
    fullHandle: "myorg/myapp",
    apiKey: "your-api-key"
)

if let preview = try await sdk.checkForUpdate() {
    print("New version available: \(preview.version ?? "unknown")")
}

Zatrzymanie monitorowania aktualizacji {#sdk-stop-monitoring}.

monitorPreviewUpdates zwraca zadanie `` , które można anulować:

let task = sdk.monitorPreviewUpdates { preview in
    // Handle update
}

// Later, to stop monitoring:
task.cancel()

:: info

Sprawdzanie aktualizacji jest automatycznie wyłączane w symulatorach i kompilacjach App Store.

:::

Identyfikator README

Aby zwiększyć widoczność podglądów Tuist w repozytorium, można dodać plakietkę do pliku README, która wskazuje na najnowszy podgląd Tuist:

Aby dodać plakietkę do swojego pliku README, użyj poniższego znacznika i zastąp uchwyty konta i projektu własnymi:

[![Tuist Preview](https://tuist.dev/{account-handle}/{project-handle}/previews/latest/badge.svg)](https://tuist.dev/{account-handle}/{project-handle}/previews/latest)

Jeśli projekt zawiera wiele aplikacji z różnymi identyfikatorami pakietów, można określić, do którego podglądu aplikacji ma prowadzić łącze, dodając parametr zapytania bundle-id:

[![Tuist Preview](https://tuist.dev/{account-handle}/{project-handle}/previews/latest/badge.svg)](https://tuist.dev/{account-handle}/{project-handle}/previews/latest?bundle-id=com.example.app)

Automatyzacje

Można użyć flagi --json, aby uzyskać dane wyjściowe JSON z polecenia tuist share:

tuist share --json

Dane wyjściowe JSON są przydatne do tworzenia niestandardowych automatyzacji, takich jak publikowanie wiadomości Slack przy użyciu dostawcy CI. JSON zawiera klucz url z pełnym linkiem do podglądu oraz klucz qrCodeURL z adresem URL do obrazu kodu QR, aby ułatwić pobieranie podglądów z rzeczywistego urządzenia. Przykład danych wyjściowych JSON znajduje się poniżej:

{
  "id": 1234567890,
  "url": "https://cloud.tuist.io/preview/1234567890",
  "qrCodeURL": "https://cloud.tuist.io/preview/1234567890/qr-code.svg"
}