XCode 12.4 日本語化計画：Swift Tutorials

セクション 1

ランドマークモデルを作成




最初のチュートリアルでは、すべてのカスタムビューに情報をハードコーディングします。ここでは、ビューに渡すことができるデータを保存するためのモデルを作成します。




前のチュートリアルで完成したプロジェクトと、このチュートリアルのプロジェクトファイルから入手できるリソースを使用して開始します。














ステップ 1

ダウンロードしたファイルの Resources フォルダにある landmarkData.json をプロジェクトのナビゲーションペインにドラッグします。表示されるダイアログで、[必要に応じてアイテムをコピーする] と [Landmarks(ランドマーク)] ターゲットを選択し、[Finish(完了)] をクリックします。




---




このサンプルデータは、このチュートリアルの残りの部分と、それに続くすべての部分を使用します。








ステップ 2

[File(ファイル)] > [New(新規)] > [File(ファイル)] を選択して、プロジェクト内に新しい Swift ファイルを作成し、Landmark.swift という名前を付けます。







ステップ 3

ラLandmark 構造体を、landmarkData.json データファイル内のいくつかのキーの名前と一致するいくつかのプロパティで定義します。




---




Codable 適合性を追加すると、データファイルから構造体にデータを簡単にロードすることができます。これについては、このセクションの後半で行います。














次のいくつかのステップでは、各ランドマークに関連した画像をモデル化して下さい。









ステップ 4

JPG ファイルをプロジェクトファイルの Resources(リソース)フォルダからプロジェクトのアセットカタログにドラッグします。Xcode は、画像ごとに新しい画像セットを作成します。




---




新しい画像は、前のチュートリアルで追加した Turtle Rock の画像に加わります。









ステップ 5

データから画像の名前を読み取るための imageName プロパティと、アセットカタログから画像をロードする計算された image プロパティを追加します。




---




Landmarks 構造体のユーザは画像自体のみを管理するため、プロパティを private にします。














次に、ランドマークの位置に関する情報を管理します。




ステップ 6

JSON データ構造体の保管場所を反映する入れ子にされた Coordinates 型を使用して、coordinatesプロパティを構造体に追加します。




---




次のステップで public の計算されたプロパティを作成するためにのみ使用するため、このプロパティを private としてマークします。














ステップ 7

MapKit フレームワークとのやり取りに役立つ locationCoordinate プロパティを計算します。














最後に、ファイルからのランドマークで初期化された配列を作成します。


































ステップ 8

プロジェクト内に新しい Swift ファイルを作成し、ModelData.swift という名前を付けます。














ステップ 9

アプリの main バンドルから指定された名前の JSON データを fetch する load(_:) メソッドを作成します。




---




load メソッドは、戻り値の型が Codable プロトコルへの準拠に依存しています。










ステップ 10

LandmarkData.json から初期化するランドマークの配列を作成します。






先に進む前に、関連するファイルをグループ化して、成長するプロジェクトの管理を容易にしましょう。






ステップ 11

ContentView.swift、CircleImage.swift、および MapView.swift を Views グループに、landmarkData.json を Resources グループに、Landmark.swift とModelData.swift を Model グループに配置します。




---



• ヒント

グループに追加すべき項目を選択し、Xcode メニューの [File(ファイル)] > [New(新規)] > [Group from Selection(選択からグループ)] を選択すると、既存のアイテムのグループを作成できます。




訳注：以下、セクション 8 まで同じファイルで説明が続けられていますが、煩わしさを避け、以下一つのセクションを一つのファイルで管理することにしました。

    Landmark.swift

1. import Foundation
3. struct Landmark: Hashable, Codable {
4. var id: Int
5. var name: String
6. var park: String
7. var state: String
8. var description: String
9. }

    Landmark.swift

1. import Foundation
import SwiftUI
3. struct Landmark: Hashable, Codable {
4. var id: Int
5. var name: String
6. var park: String
7. var state: String
8. var description: String
 
private var imageName: String
var image: Image {
Image(imageName)
}
9. }

15 行からを以下のように書き足します。

private var coordinates: Coordinates
struct Coordinates: Hashable, Codable {
var latitude: Double
var longitude: Double
}
15. }

これを以下のように換えます。

    Landmark.swift

1. import Foundation
2. import SwiftUI
import CoreLocation
4. struct Landmark: Hashable, Codable {
5. var id: Int
6. var name: String
7. var park: String
8. var state: String
9. var description: String
11. private var imageName: String
12. var image: Image {
13. Image(imageName)
14. }
16. private var coordinates: Coordinates
var locationCoordinate: CLLocationCoordinate2D {
CLLocationCoordinate2D(
latitude: coordinates.latitude,
longitude: coordinates.longitude)
}
18. struct Coordinates: Hashable, Codable {
19. var latitude: Double
20. var longitude: Double
21. }
22. }

    ModelData.swift

1. import Foundation
3. func load<T: Decodable>(_ filename: String) -> T {
4. let data: Data
6. guard let file = Bundle.main.url(forResource: filename, withExtension: nil)
7. else {
8. fatalError("Couldn't find \(filename) in main bundle.")
9. }
11. do {
12. data = try Data(contentsOf: file)
13. } catch {
14. fatalError("Couldn't load \(filename) from main bundle:\n\(error)")
15. }
17. do {
18. let decoder = JSONDecoder()
19. return try decoder.decode(T.self, from: data)
20. } catch {
21. fatalError("Couldn't parse \(filename) as \(T.self):\n\(error)")
22. }
23. }

上記のリストの 2 行目の所に以下のリストを付け加えます。

var landmarks: [Landmark] = load("landmarkData.json")