ページビューの合計

2026年10月21日水曜日

iOSアプリの開発(100 Days of SwiftUI) Day 21 – Project 2, part two

100 Days of SwiftUIのDay21です。 

プログラミング学習中に人々がよく不満に思うことの一つは、自分が思いついた壮大なアプリのアイデアを実現したいのに、実際には全く異なるアプリを作るチュートリアルに従わなければならないということです。

これを面倒に感じるかもしれませんが、信じてください。ここで学んでいることは決して無駄になりません。確かに、旗当てゲームを作ることはないかもしれませんが、ここで学ぶ概念――レイアウトの構築、状態の追跡、配列のランダム化など――は、今後何年も役に立つでしょう。

オプラ・ウィンフリーはかつてこう言いました。「やりたいことができるようになるまで、やらなければならないことをやりなさい」。
この100日間のコースが終わる頃には、あなたがまさにやりたいことができるようになっていることを願っていますが、それまでの間は諦めずに続けてください。ここであなたは重要なスキルを学んでいるのですから!

今日は3つのトピックに取り組みます。これらのトピックでは、VStack、LinearGradient、アラートなどに関する知識を応用します。

1. Stacking up buttons

アプリ開発は、まず基本的なUI構造の構築から始めます。これは、ユーザーに何をすべきかを伝える2つのラベルと、3つの世界の国旗を表示する3つの画像ボタンで構成されます。

まず、このプロジェクトで使用するアセットを見つけて、アセットカタログにドラッグします。つまり、XcodeでAssets.xcassetsを開き、project2-filesフォルダから国旗の画像をドラッグします。画像には国名に加えて@2xまたは@3xという名前が付いていることに気づくでしょう。
これらは、さまざまな種類のiPhone画面に対応するために、2倍の解像度と3倍の解像度で作成された画像です。


補足
Gitのレポジトリからダウンロードしておきます。

プロジェクトナビゲーター(一番左のツリー)でなくて、Assetsを開くとAccentColroとAppIconが見えます。
その下辺りにドラッグ&ドロップします。


そうするとこんな感じでXcode上で見えるようになります。

フォルダ上で見るとAssets.xcassetsの下に国旗毎のフォルダに分かれて画像とContents.jsonが格納されているのがわかります。


次に、ゲームデータを格納するための2つのプロパティが必要です。
1つはゲームに表示したいすべての国の画像の配列、もう1つはどの国の画像が正しいかを格納する整数です。
var countries = ["Estonia", "France", "Germany", "Ireland", "Italy", "Nigeria", "Poland", "Spain", "UK", "Ukraine", "US"]
var correctAnswer = Int.random(in: 0...2)
Int.random(in:) メソッドは乱数を自動的に選択するので、ここでは最適です。どの国の国旗をタップするかを決定するために使用します。

bodyでゲームのプロンプトを縦方向に積み重ねる必要があるので、まずはそこから始めましょう。
var body: some View {
    VStack {
        Text("Tap the flag of")
        Text(countries[correctAnswer])
    }
}
その下にはタップ可能な旗ボタンを配置したいのですが、同じ VStack に追加することもできますが、間隔をより細かく制御できるように、2 つ目の VStack を作成することもできます。

先ほど作成したVStackには2つのテキストビューが含まれており、間隔は空いていませんが、フラグの間には30ポイントの間隔を設けることで、見栄えを良くします。
それでは、先ほど作成した VStack を、今度は間隔を 30 にした別の VStack でラップし、新しい ForEach ループを追加します。
VStack(spacing: 30) {
    VStack {
        Text("Tap the flag of")
        Text(countries[correctAnswer])
    }

    ForEach(0..<3) { number in
        Button {
           // flag was tapped
        } label: {
            Image(countries[number])
        }
    }
}

このように2つの垂直スタックを使用することで、要素をより正確に配置できます。
外側のスタックは各ビューの間隔を30ポイントずつ確保しますが、内側のスタックにはカスタム間隔は設定されません。

これでユーザーインターフェースの基本的なイメージは掴めると思いますが、既に見た目が良くないことがお分かりいただけるでしょう。一部の旗には白が含まれており、背景に溶け込んでしまっています。また、すべての旗が画面の中央に垂直に配置されています。

UIの調整は後で行いますが、とりあえずフラグが見やすくなるように背景色を青にしましょう。外側のVStackの背後に何かを配置する必要があるため、ZStackも使用する必要があります。そうです、ZStackの中にVStack、さらにその中にVStackがあるという構造になりますが、これは全く問題ありません。

補足
現時点ではこんな感じの画面になります。上記のようにここから各種調整をしていきます。
また、アセットに登録した画像は、Image("登録名")で参照できます。
以下のようにcountries[number]がアセットに登録した名前と一致しているので番号を指定するだけで参照が可能となります。
        } label: {
            Image(countries[number])
        }


まず、外側のVStackの周りにZStackを配置します。以下のようにします。

var body: some View {
    ZStack {
        // previous VStack code
    }
}

これをZStackのすぐ内側に配置して、外側のVStackの後ろにくるようにします。

Color.blue
    .ignoresSafeArea()

その .ignoresSafeArea() 修飾子により、色が画面の端まで確実に表示されます。

背景色が暗くなったので、テキストの色を明るくして、より目立つようにしましょう。

Text("Tap the flag of")
    .foregroundStyle(.white)

Text(countries[correctAnswer])
    .foregroundStyle(.white)

補足
現時点の調整でこうなります。


このデザインは世界を席巻するようなものではありませんが、確かなスタートです!

2. Showing the player’s score with an alert

このゲームを面白くするためには、旗が表示される順番をランダム化し、旗をタップするたびに正解か不正解かを知らせるアラートを表示し、その後旗を再びシャッフルする必要があります。
correctAnswerには既にランダムな整数を設定していますが、国旗の並び順が常に同じです。これを修正するには、ゲーム開始時に国の配列をシャッフルする必要があります。そのため、プロパティを以下のように変更してください。

var countries = ["Estonia", "France", "Germany", "Ireland", "Italy", "Nigeria", "Poland", "Spain", "UK", "Ukraine", "US"].shuffled()

ご覧のとおり、shuffled() メソッドは配列の順序を自動的にランダム化してくれます。

さて、ここからがもっと面白い部分です。旗がタップされたら、どうするべきでしょうか? // flag was tapped コメントを、正しい旗がタップされたかどうかを判断するコードに置き換える必要があります。
そのための最良の方法は、ボタンの整数を受け取り、それが correctAnswer プロパティと一致するかどうかをチェックする新しいメソッドを使用することです。

正解か不正解かにかかわらず、ユーザーが進捗状況を把握できるよう、何が起こったのかを示すアラートを表示したいと考えています。そこで、アラートが表示されているかどうかを保存するプロパティを追加します。

@State private var showingScore = false

アラート内に表示されるタイトルを保存するには、このプロパティを追加します。

@State private var scoreTitle = ""

つまり、私たちが作成するメソッドは、タップされたボタンの番号を受け取り、それを正解と比較し、意味のあるアラートを表示できるように、2つの新しいプロパティを設定することになります。
bodyプロパティの直後に以下を追加してください。

func flagTapped(_ number: Int) {
    if number == correctAnswer {
        scoreTitle = "Correct"
    } else {
        scoreTitle = "Wrong"
    }

    showingScore = true
}

補足
bodyプロパティの直後という紛らわしい書き方をしているので、
bodyプロパティの中に書いたら、「Closure containing a declaration cannot be used with result builder 'ViewBuilder'」というエラーになりました。
SwiftUIの body の中では、UIの構成要素(ビュー)しか記述できないため、関数などの宣言を書くとこのエラーが発生します。
なので以下のように書きます。

var body: some View {

}

func flagTapped(_ number: Int) {
    if number == correctAnswer {
        scoreTitle = "Correct"
    } else {
        scoreTitle = "Wrong"
    }
    showingScore = true
}

これで、// flag was tapped コメントを次のものに置き換えることで、それを呼び出すことができます。
flagTapped(number)

ForEach によって既に数値が与えられているので、それを flagTapped() に渡すだけで済みます。
アラートを表示する前に、アラートが解除されたときに何が起こるかを考える必要があります。当然ながら、ゲームは終了してはいけません。そうでなければ、すべてが即座に終了してしまうからです。
代わりに、国をシャッフルして新しい正解を選択することでゲームをリセットするaskQuestion()メソッドを作成します。

func askQuestion() {
    countries.shuffle()
    correctAnswer = Int.random(in: 0...2)
}

このコードはコンパイルできません。
理由はすぐに分かると思いますが、@State でマークされていないビューのプロパティを変更しようとしているためです。これは許可されていません。
したがって、countries と correctAnswer が宣言されている場所に移動し、その前に @State private を追加してください。

@State private var countries = ["Estonia", "France", "Germany", "Ireland", "Italy", "Nigeria", "Poland", "Spain", "UK", "Ukraine", "US"].shuffled()
@State private var correctAnswer = Int.random(in: 0...2)

補足
上記を付与しないと以下のメッセージを表示します。
どっちも不変だからだめってことですね。

Cannot use mutating member on immutable value: 'self' is immutable
Cannot assign to property: 'self' is immutable

これでアラートを表示する準備が整いました。アラートには以下の機能が必要です。

  • alert()修飾子を使用すると、showingScoreがtrueの場合にアラートが表示されます。
  • scoreTitleで設定したタイトルを表示します。
  • タップするとaskQuestion()を呼び出す閉じるボタンを用意してください。

それでは、これをZStackのbodyプロパティの最後に追加してください。

.alert(scoreTitle, isPresented: $showingScore) {
    Button("Continue", action: askQuestion)
} message: {
    Text("Your score is ???")
}

補足
以前も書きましたが修飾子はViewであればどこでも記載できます。
ボタンに記載しなくても大丈夫です。
また、bodyプロパティの最後って表現紛らわしいですね。以下のように書いてエラーなりました。

var body: some View {

}
←ここ(間違い)

正確にはZStackの下です。

var body: some View {
    ZStack {

    }
    ←ここ(正しい)
}


はい、スコア値が格納されるはずの疑問符が3つあります。その部分はまもなく完了します!

3. Styling our flags

ゲームは動作するようになったものの、見た目はあまり良くありません。
幸いなことに、デザインに少し手を加えることで、全体的な見栄えを改善できます。

まず、背景の単色の青色を、青から黒への直線的なグラデーションに変更しましょう。こうすることで、旗に似たような青い縞模様があっても、背景から際立つようになります。

それでは、この行を探してください。

Color.blue
    .ignoresSafeArea()

そして、これをこれに置き換えてください。

LinearGradient(colors: [.blue, .black], startPoint: .top, endPoint: .bottom)
    .ignoresSafeArea()

それでも安全領域は無視され、背景が画面の端から端まで表示されるようになります。

それでは、使用するフォントを少し調整しましょう。推測する必要のある国名が画面上で最も目立つテキストになり、「国旗をタップしてください」というテキストは小さく太字になります。
フォントサイズとスタイルは、iOSに組み込まれているフォントサイズから選択できるfont()修飾子を使用して制御できます。フォントの太さ(極細のテキスト、やや太字のテキストなど)を調整するには、使用するフォントにweight()修飾子を追加することで、より細かく制御できます。

ここでは両方を使って、実際に動作を確認してみましょう。「旗をタップ」というテキストの直後に、次のテキストを追加してください。

.font(.subheadline.weight(.heavy))

そして、以下の修飾子を Text(countries[correctAnswer]) ビューの直後に配置します。

.font(.largeTitle.weight(.semibold))

"Large title"は、iOSに標準搭載されているフォントサイズの中で最大のもので、ユーザーのフォント設定に応じて自動的に拡大縮小されます。これは「ダイナミックタイプ」と呼ばれる機能です。今回はフォントの太さを少し太くしていますが、必要に応じて自動的に拡大縮小されます。

最後に、国旗の画像を少し装飾してみましょう。SwiftUIには、ビューの表示方法に影響を与えるための修飾子がいくつか用意されていますが、ここではそのうちの2つを使用します。1つは国旗の形状を変更するもので、もう1つは影を追加するものです。

Swiftには、長方形、角丸長方形、円、カプセルの4つの組み込みシェイプがあります。
ここではカプセルを使用します。カプセルは、最短辺の角が完全に丸くなり、最長辺は直線のままになるため、ボタンに最適です。画像をカプセル型にするには、次のように.clipShape(.capsule)モディファイアを追加するだけで簡単にできます。

.clipShape(.capsule)

最後に、各旗の周りに影の効果を適用して、背景から際立たせたいと思います。これは、影の色、半径、X座標、Y座標のオフセットを指定するshadow()関数を使用して行います。色を省略すると半透明の黒になり、X座標とY座標を省略すると0になります。これらはすべて妥当なデフォルト値です。
それでは、前の2つの修飾子の下に、この最後の修飾子を追加してください。

.shadow(radius: 5)

完成した国旗の画像は次のようになります。

Image(countries[number])
    .clipShape(.capsule)
    .shadow(radius: 5)

SwiftUIには、フォントや画像のレンダリング方法を調整するのに役立つ修飾子が多数あります。これらの修飾子はすべて1つの機能しか持たないため、上記のように重ねて使用するのが一般的です。

4. Upgrading our design

ここまででアプリは完成し、正常に動作していますが、これまでに学んだSwiftUIのスキルを駆使して、作成したアプリのUIをカスタマイズしてみましょう。
つまり、現在構築中のプロジェクトのUIを別のものに作り変えるのです。これはロジックには全く影響しません。皆さんの現在の知識で何ができるかを確認するために、いくつかの異なるUIを試してみるだけです。

このようなデザインを試行錯誤するのはとても楽しいのですが、一つだけ注意点があります。少なくとも、iPhone SEのような小型デバイスからiPhone 15 Pro Maxのような大型デバイスまで、あらゆるサイズのiOSデバイスでコードを実行するようにしてください。これほど幅広い画面サイズでうまく動作するものを見つけるには、それなりの工夫が必要です。

まずは、旗の背景にある青黒のグラデーションから始めましょう。これで始められましたが、今度はもう少し凝ったもの、つまりカスタムストップ付きの放射状グラデーションを試してみたいと思います。

以前、グラデーションのストップ位置を非常に正確に設定することで、グラデーションの描画方法を調整できることをご紹介しました。さて、ストップ位置を2つ作成して位置を全く同じにすると、グラデーションは完全に消え、色が一方から他方へ直接切り替わります。現在のデザインで試してみましょう。
RadialGradient(stops: [
    .init(color: .blue, location: 0.3),
    .init(color: .red, location: 0.3),
], center: .top, startRadius: 200, endRadius: 700)
    .ignoresSafeArea()

それは面白い効果だと思います。まるで赤い背景の上に青い円が重ねられているようです。
とはいえ、見た目はあまり良くありません。赤と青の色が合わさると、明るすぎるのです。

補足
現状でこんな感じです。


そこで、同じ色でもトーンを抑えたバージョンを送ることで、より調和のとれた印象の色合い、つまり国旗でよく使われる色合いを作り出すことができます。

RadialGradient(stops: [
    .init(color: Color(red: 0.1, green: 0.2, blue: 0.45), location: 0.3),
    .init(color: Color(red: 0.76, green: 0.15, blue: 0.26), location: 0.3),
], center: .top, startRadius: 200, endRadius: 400)
    .ignoresSafeArea()

次に、現在、質問エリアとフラグを配置するために間隔30のVStackを使用していますが、これを15に減らしたいと思います。

VStack(spacing: 15) {

なぜかって?それは、そのエリア全体をUIの視覚要素として活用し、角が丸い色付きの長方形にすることで、ゲームのその部分が画面上で目立つようにするからです。

そのためには、同じ VStack の末尾に以下の修飾子を追加します。

.frame(maxWidth: .infinity)
.padding(.vertical, 20)
.background(.regularMaterial)
.clipShape(.rect(cornerRadius: 20))

これにより、必要な水平方向のスペースをすべて占めるようにサイズが変更され、垂直方向に少し余白が追加され、背景の赤と青のグラデーションから際立つように背景素材が適用され、最後に全体が角丸長方形の形に切り抜かれます。

すでにかなり良くなっていると思いますが、このまま頑張り続けましょう!

補足
現状でこんな感じです。良くなったのかは正直微妙w


次のステップは、メインボックスの前にタイトルを追加し、後にスコアのプレースホルダーを追加することです。これは、既存の VStack(spacing: 15) にマテリアル効果を適用しているため、これまでの内容の周りに別の VStack を追加することを意味します。

そこで、現在のVStackを、上部にタイトルを指定した新しいVStackでラップします。

VStack {
    Text("Guess the Flag")
        .font(.largeTitle.weight(.bold))
        .foregroundStyle(.white)

    // current VStack(spacing: 15) code
}

ヒント:太字フォントを要求することはよくあるので、実はちょっとしたショートカットがあります:.font(.largeTitle.bold())。

これにより上部に新しいタイトルが追加されますが、新しいVStackの下部にスコアラベルを挿入することもできます。

Text("Score: ???")
    .foregroundStyle(.white)
    .font(.title.bold())

「国旗当てクイズ」のタイトルとスコアラベルはどちらも白文字で見栄えが良いのですが、枠内の文字はそうではありません。元々は暗い背景の上に表示されていたため白にしたのですが、今となっては非常に読みにくくなっています。

この問題を解決するには、Text(countries[correctAnswer]) の foregroundStyle() 修飾子を削除して、システムのプライマリカラー(ライトモードでは黒、ダークモードでは白)をデフォルトで使用するようにします。

白い“Tap the flag of”については、iOSの鮮やかさ効果を使って背景色が少し透けて見えるようにします。foregroundStyle()修飾子を次のように変更してください。

.foregroundStyle(.secondary)

現時点ではUIはほぼ機能していますが、少し窮屈すぎるように感じます。
大型デバイスを使用している場合、コンテンツがすべて画面の中央に配置され、上下にかなりの余白があり、中央の白いボックスが画面の端まで伸びているのがわかるでしょう。

この問題を解決するために、2つのことを行います。まず、一番外側のVStackに少しパディングを追加し、次にSpacer()ビューを追加してUI要素間の間隔を強制的に広げます。
大型デバイスではこれらのスペーサーが要素間の利用可能なスペースを分割しますが、小型デバイスではほとんど見えなくなります。これは、あらゆる画面サイズでUIを適切に動作させるための優れた方法です。

追加してほしいスペーサーが4つあります。

  • 「国旗を当てよう」というタイトルの直前に1つ。
  • 「スコア: ???」というテキストの直前に 2 つ (そうです、2 つ)。
  • そして「スコア:???」というテキストの直後にもう一つ。
複数のスペーサーを使用する場合、利用可能なスペースは自動的に均等に分割されることを覚えておいてください。
スペーサーを2つ並べると、1つのスペーサーの場合の2倍のスペースを占有することになります。
あとは、一番外側のVStackの周りに少しパディングを追加するだけです。

.padding()

これで刷新されたデザインが完成です!これらのスペーサーのおかげで、iPod touchのような小型デバイスでも、Pro Max iPhoneでもスムーズに拡大縮小して見栄えが良くなります。

しかし、これはあくまでアプリのデザインの一例に過ぎません。もしかしたら、以前のデザインの方がお好みかもしれませんし、別のデザインを試してみたいかもしれません。重要なのは、既に持っているわずかなSwiftUIのスキルでも、全く異なるデザインを構築できることがお分かりいただけたということです。もし時間があれば、ぜひ色々と試してみて、どんなデザインになるか見てみてください!

補足
現状でこんな感じです。なんかかなり微妙



0 件のコメント:

コメントを投稿

iOSアプリの開発(100 Days of SwiftUI) Day 26 – Project 4, part one

100 Days of SwiftUIの Day26 です。 今日から新しいプロジェクトを始めます。SwiftUIのスキルをさらに磨きながら、プログラミングの魅力的な分野である機械学習にも挑戦していきます。 オックスフォード大学で教鞭を執るスウェーデン人教授、ニック・ボストロムは...