시작하기

이 문서는 설치부터 첫 데이터 조회까지의 최소 흐름을 안내합니다.

설치

Unity Package Manager의 Add package from git URL... 메뉴에 아래 주소를 입력합니다.

https://github.com/achieveonepark/lite-db.git

의존성

Unity 2022.3 이상을 대상으로 합니다.

DB 파일 준비

LiteDB는 SQLite DB 파일을 읽어서 C# 모델로 매핑합니다. DB 파일은 DB Browser for SQLite 같은 도구로 만들 수 있습니다.

기본 초기화 API는 다음 위치를 사용합니다.

원본 DB 파일을 StreamingAssets/data/file.db 위치에 둡니다.

데이터 모델 작성

조회할 테이블에 대응하는 C# 클래스를 작성합니다. Id를 Primary Key로 두는 것을 권장합니다.

using Achieve.Database;
using SQLite;

[Table("Quest")]
public sealed class Quest : IDataBase
{
    [PrimaryKey]
    public int Id { get; set; }
    public string Name { get; set; }
    public int RewardGold { get; set; }
}

초기화와 첫 조회

게임 시작 시 await LiteDB.Initialize()를 호출하면 원본 DB 파일을 런타임 경로로 복사한 뒤 연결합니다. 이후 LiteDB.Get<T>(id) 같은 API로 데이터를 읽습니다.

await LiteDB.Initialize();

var quest = LiteDB.Get<Quest>(1);
if (LiteDB.TryGetValue<Quest>(2, out var nextQuest))
{
    Debug.Log(nextQuest.Name);
}

다음 단계

• 사용법 › 데이터 모델 — 모델 규칙과 Attribute
• API — 전체 런타임 API