セクション 101

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

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

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

ステップ 1

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

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

ステップ 2

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

ステップ 3

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

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

    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. }

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

ステップ 4

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

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

ステップ 5

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

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

    Landmark.swift

1. import Foundation
import SwiftUI
3. struct Landmark: Hashable, Codable {

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

ステップ 6

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

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

    Landmark.swift

13. Image(imageName)
14. }
private var coordinates: Coordinates
struct Coordinates: Hashable, Codable {
var latitude: Double
var longitude: Double
}
15. }

15 行からを上のように書き足しました。

ステップ 7

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

    Landmark.swift

1. import Foundation
2. import SwiftUI
import CoreLocation
4. struct Landmark: Hashable, Codable {
5. var id: Int
6. var name: String

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

ステップ 8

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

ステップ 9

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

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

    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. }





ステップ 10

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





    ModelData.swift



1. import Foundation
var landmarks: [Landmark] = load("landmarkData.jason")
3. func load<T: Decodable>(_ filename: String) -> T {
4. let data: Data





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





ステップ 11

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




---




ヒント

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











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



セクション 1	セクション 2	セクション 3	セクション 4
セクション 5	セクション 6	セクション 7	セクション 8
セクション 101	セクション 102	セクション 103	セクション 104
セクション 105	セクション 106	セクション 107	セクション 108