UUVPN/iOS-SwiftUI-Code/GRDB.swift-6.29.3/Documentation/DemoApps/GRDBDemoiOS/README.md

UIKit Demo Application

This demo application is a storyboard-based UIKit application. For a demo application that uses Combine + SwiftUI, see GRDBCombineDemo, and for Async/Await + SwiftUI, see GRDBAsyncDemo.

Requirements: iOS 15.0+ / Xcode 12+

Note

: This demo app is not a project template. Do not copy it as a starting point for your application. Instead, create a new project, choose a GRDB installation method, and use the demo as an inspiration.

The topics covered in this demo are:

• How to setup a database in an iOS app.
• How to define a simple Codable Record.
• How to track database changes and animate a table view with ValueObservation.
• How to apply the recommendations of Recommended Practices for Designing Record Types.

Files of interest:

• AppDatabase.swift

  AppDatabase is the type that grants database access. It uses DatabaseMigrator in order to setup the database schema, and ValueObservation in order to let the application observe database changes.

• Persistence.swift

  This file defines the AppDatabase instance used by the application.

• Player.swift

  Player is a Record type, able to read and write in the database. It conforms to the standard Codable protocol in order to gain all advantages of Codable Records. It defines the database requests used by the application.

• PlayerListViewController.swift

  PlayerListViewController displays the list of players.

• PlayerEditionViewController.swift

  PlayerEditionViewController can create or edit a player, and save it in the database.

• GRDBDemoiOSTests

  • Test the database schema
  • Test the Player record and its requests
  • Test the AppDatabase methods that let the app access the database.