Xcodeプロジェクトを移行する

Tuistを使用して新しいプロジェクトを作成しない限り、自動的にすべてが設定されるので、Tuistのプリミティブを使用してXcodeプロジェクトを定義する必要があります。この作業がどの程度面倒かは、あなたのプロジェクトがどの程度複雑かによる。

ディレクトリ構造と一致しないグループ、ターゲット間で共有されるファイル、存在しないファイルを指すファイル参照（いくつか挙げると）。このような複雑さが蓄積すると、プロジェクトを確実に移行するコマンドを提供することが難しくなります。

さらに、手作業での移行は、プロジェクトをクリーンアップし、シンプルにするための優れたエクササイズです。あなたのプロジェクトの開発者だけでなく、Xcodeもそのことに感謝するだろう。ひとたびTuistを完全に採用すれば、プロジェクトが一貫して定義され、シンプルなままであることを確認できるだろう。

その作業を軽減する目的で、ユーザーから寄せられたフィードバックに基づいたガイドラインをいくつか紹介する。

プロジェクト・スキャフォールドの作成

まず、以下のTuistファイルでプロジェクトの足場を作る：

Tuist.swift

import ProjectDescription

let tuist = Tuist()

Project.swift

import ProjectDescription

let project = Project(
    name: "MyApp-Tuist",
    targets: [
        /** Targets will go here **/
    ]
)

Tuist/Package.swift

// swift-tools-version: 5.9
import PackageDescription

#if TUIST
    import ProjectDescription

    let packageSettings = PackageSettings(
        // Customize the product types for specific package product
        // Default is .staticFramework
        // productTypes: ["Alamofire": .framework,]
        productTypes: [:]
    )
#endif

let package = Package(
    name: "MyApp",
    dependencies: [
        // Add your own dependencies here:
        // .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
        // You can read more about dependencies here: https://docs.tuist.io/documentation/tuist/dependencies
    ]
)

Project.swift はプロジェクトを定義するマニフェスト・ファイルで、Package.swift は依存関係を定義するマニフェスト・ファイルです。Tuist.swift ファイルは、プロジェクトのためにプロジェクト・スコープのTuist設定を定義する場所です。

プロジェクト名と-TUISTサフィックス

既存のXcodeプロジェクトとのコンフリクトを防ぐため、プロジェクト名に-Tuist という接尾辞をつけることをお勧めします。プロジェクトをTuistに完全に移行したら、この接尾辞を削除することができます。

CIでTuistプロジェクトをビルドしてテストする

各変更の移行が有効であることを確認するために、継続的インテグレーションを拡張して、マニフェストファイルからTuistが生成したプロジェクトをビルドし、テストすることをお勧めします：

tuist install
tuist generate
tuist build -- ...{xcodebuild flags} # or tuist test

プロジェクトのビルド設定を.xcconfig ファイルに展開する {#extract-the-project-build-settings-into-xcconfig-files} 。

プロジェクトからのビルド設定を.xcconfig ファイルに抽出すると、プロジェクトがスリムになって移行しやすくなります。次のコマンドを使用して、プロジェクトからビルド設定を.xcconfig ファイルに抽出できます：

mkdir -p xcconfigs/
tuist migration settings-to-xcconfig -p MyApp.xcodeproj -x xcconfigs/MyApp-Project.xcconfig

次に、Project.swift ファイルを更新し、先ほど作成した.xcconfig ファイルを指すようにします：

import ProjectDescription

let project = Project(
    name: "MyApp",
    settings: .settings(configurations: [
        .debug(name: "Debug", xcconfig: "./xcconfigs/MyApp-Project.xcconfig"), 
        .release(name: "Release", xcconfig: "./xcconfigs/MyApp-Project.xcconfig"), 
    ]),
    targets: [
        /** Targets will go here **/
    ]
)

次に、継続的インテグレーション・パイプラインを拡張して以下のコマンドを実行し、ビルド設定の変更が.xcconfig ファイルに直接行われるようにする：

tuist migration check-empty-settings -p Project.xcodeproj

パッケージの依存関係を抽出する {#extract-package-dependencies}.

プロジェクトの依存関係をすべて、Tuist/Package.swift ファイルに展開します：

// swift-tools-version: 5.9
import PackageDescription

#if TUIST
    import ProjectDescription

    let packageSettings = PackageSettings(
        // Customize the product types for specific package product
        // Default is .staticFramework
        // productTypes: ["Alamofire": .framework,]
        productTypes: [:]
    )
#endif

let package = Package(
    name: "MyApp",
    dependencies: [
        // Add your own dependencies here:
        // .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
        // You can read more about dependencies here: https://docs.tuist.io/documentation/tuist/dependencies
        .package(url: "https://github.com/onevcat/Kingfisher", .upToNextMajor(from: "7.12.0")) 
    ]
)

製品タイプ

PackageSettings struct内のproductTypes dictionaryに追加することで、特定のパッケージの製品タイプをオーバーライドできます。デフォルトでは、Tuistはすべてのパッケージが静的フレームワークであると仮定しています。

:::

移行順序の決定

依存関係の大きいものから小さいものへとターゲットを移行することをお勧めします。次のコマンドを使うと、プロジェクトのターゲットを依存関係の数でソートしてリストアップできます：

tuist migration list-targets -p Project.xcodeproj

リストの上位から移行を開始する。

ターゲットを移行する

ターゲットを1つずつ移行する。変更をマージする前にレビューとテストを確実に行うために、ターゲットごとにプルリクエストを行うことを推奨します。

ターゲットビルド設定を.xcconfig ファイルに展開する {#extract-the-target-build-settings-into-xcconfig-files} 。

プロジェクトのビルド設定で行ったように、ターゲットのビルド設定を.xcconfig ファイルに抽出すると、ターゲットがスリムになり、移行しやすくなります。次のコマンドを使用して、ターゲットからビルド設定を.xcconfig ファイルに抽出できます：

tuist migration settings-to-xcconfig -p MyApp.xcodeproj -t TargetX -x xcconfigs/TargetX.xcconfig

Project.swift ファイル {#define-the-target-in-the-projectswift-file} でターゲットを定義します。

Project.targets でターゲットを定義する：

import ProjectDescription

let project = Project(
    name: "MyApp",
    settings: .settings(configurations: [
        .debug(name: "Debug", xcconfig: "./xcconfigs/Project.xcconfig"),
        .release(name: "Release", xcconfig: "./xcconfigs/Project.xcconfig"),
    ]),
    targets: [
        .target( 
            name: "TargetX", 
            destinations: .iOS, 
            product: .framework, // [!code ++] // or .staticFramework, .staticLibrary...
            bundleId: "dev.tuist.targetX", 
            sources: ["Sources/TargetX/**"], 
            dependencies: [ 
                /** Dependencies go here **/
                /** .external(name: "Kingfisher") **/
                /** .target(name: "OtherProjectTarget") **/
            ], 
            settings: .settings(configurations: [ 
                .debug(name: "Debug", xcconfig: "./xcconfigs/TargetX.xcconfig"), 
                .debug(name: "Release", xcconfig: "./xcconfigs/TargetX.xcconfig"), 
            ]) 
        ), 
    ]
)

::: info・テスト・ターゲット

ターゲットに関連するテストターゲッ トがある場合は、Project.swift ファイルで定義し、同じ手順を繰り返します。

:::

ターゲットマイグレーションを検証する

tuist build とtuist test を実行して、プロジェクトのビルドとテストがパスすることを確認してください。さらに、xcdiff を使用して、生成された Xcode プロジェクトと既存のプロジェクトを比較し、変更が正しいことを確認できます。

リピート

すべてのターゲットが完全に移行されるまで繰り返す。完了したら、Tuistが提供するスピードと信頼性の恩恵を受けるために、tuist build とtuist test コマンドを使用してプロジェクトをビルドしテストするようにCIとCDパイプラインを更新することをお勧めします。

トラブルシューティング

ファイル不足によるコンパイルエラー。ファイルが見つからないことによるコンパイルエラー} {#compilation-errors-due-to-missing-files

Xcodeプロジェクトのターゲットに関連付けられたファイルが、ターゲットを表すファイルシステムディレクトリにすべて含まれていなかった場合、コンパイルできないプロジェクトになってしまうかもしれません。Tuistでプロジェクトを生成した後のファイルのリストがXcodeプロジェクトのファイルのリストと一致していることを確認し、この機会にファイル構造をターゲットの構造に合わせましょう。