استفاده از SQLite در یونیتی به همراه مثال

SQLite در یونیتی

با سلام

توی این آموزش قراره یکسری اطلاعات بازیمون رو به جای اینکه روی فایل یا PlayerPrefs ذخیره کنیم ، روی دیتابیس Local ذخیره کنیم .

سورس فایل ها و پروژه یونیتی کامل

این پروژه با یونیتی ۵ تست شده است .

قراره که از پلاگینی به  اسم SQLite4Unity3d استفاده کنیم . به گفته نویسنده این پلاگین ، روی موبایل هم کار می کنه .

برای این که اطلاعات دیتابیس مون رو مرور کنیم و بتونیم جداول مون رو بسازیم از یک نرم افزار ساده و محانی به اسم DB Browser for SQLite استفاده کردم .

گام اول :

یک پروژه جدید یونیتی ایجاد کنید .

گام دوم :

این لینک رو دانلود کنید و بازش کنید . پس از اکسترکت کردن باید یک فولدر ببینید به اسم Plugins که این فولدر رو عینا کپی می کنید توی فولدر Assets پروژه خودتون(اگه قبلا فولدر Plugins داشتید این با اون باید یکی بشه) . فایل SQLite.cs رو هم کپی کنید توی پروژه تون هر کجا که خواستید.

گام سوم :

توی فولدر Assets بازیتون یک فولدر به اسم StreamingAssets درست کنید .

گام چهارم :

با استفاده از نرم افزار DB Browser for SQLite یک دیتابیس توی فولدر StreamingAssets درست کنید .

تا اینجا گام های عمومی بود . یعنی اگه برای پروژه خودتون می خواهید از SQLite استفاده کنید باید این مراحل رو برید . از این جا به بعد مخصوص این مثال خاص ما خواهد بود .

من در دیتابیسم یک جدول به اسم Team ساختم که ۳ تا فیلد داره . Id ، Name ، Score .

حالا عینا توی کلاس هام هم یک کلاس به اسم Team درست کردم . به این کلاس در حقیقت مدل می گن . یعنی عینا یک مدل از شکل داده هامون توی دیتابیسمون هستش .

using UnityEngine;
using System.Collections;
using SQLite4Unity3d;

public class Team  {

	[PrimaryKey, AutoIncrement]
	public int _Id {
				get;
				set;
	}
	public string Name {
				get;
				set;
	}
	public int Score {
				get;
				set;
	}

	public override string ToString ()
	{
		return string.Format
			("[Id: Id={0}, Name={1}, Score={2}]",
			 _Id, Name, Score);
	}
}

برای اینکه با دیتابیس هم ارتباط بر قرار کنیم از این کلاس استفاده کردم.

using UnityEngine;
#if !UNITY_EDITOR
using System.Collections;
using System.IO;
#endif
using SQLite4Unity3d;
using System.Collections.Generic;

public class DatabaseHandler {

	private SQLiteConnection _connection;

	public DatabaseHandler(string DatabaseName){

		#if UNITY_EDITOR
		var dbPath = string.Format(@"Assets/StreamingAssets/{0}", DatabaseName);
		#else
		// check if file exists in Application.persistentDataPath
		var filepath = string.Format("{0}/{1}", Application.persistentDataPath, DatabaseName);

		if (!File.Exists(filepath))
		{
			Debug.Log("Database not in Persistent path");
			// if it doesn't ->
			// open StreamingAssets directory and load the db ->

			#if UNITY_ANDROID
			var loadDb = new WWW("jar:file://" + Application.dataPath + "!/assets/" + DatabaseName);  // this is the path to your StreamingAssets in android
			while (!loadDb.isDone) { }  // CAREFUL here, for safety reasons you shouldn't let this while loop unattended, place a timer and error check
			// then save to Application.persistentDataPath
			File.WriteAllBytes(filepath, loadDb.bytes);
			#elif UNITY_IOS
			var loadDb = Application.dataPath + "/Raw/" + DatabaseName;  // this is the path to your StreamingAssets in iOS
			// then save to Application.persistentDataPath
			File.Copy(loadDb, filepath);
			#elif UNITY_WP8
			var loadDb = Application.dataPath + "/StreamingAssets/" + DatabaseName;  // this is the path to your StreamingAssets in iOS
			// then save to Application.persistentDataPath
			File.Copy(loadDb, filepath);

			#elif UNITY_WINRT
			var loadDb = Application.dataPath + "/StreamingAssets/" + DatabaseName;  // this is the path to your StreamingAssets in iOS
			// then save to Application.persistentDataPath
			File.Copy(loadDb, filepath);
			#endif

			Debug.Log("Database written");
		}

		var dbPath = filepath;
		#endif
		_connection = new SQLiteConnection(dbPath, SQLiteOpenFlags.ReadWrite | SQLiteOpenFlags.Create);
		Debug.Log("Final PATH: " + dbPath);
	}

	public void addTeam(Team _team)
	{
		_connection.BeginTransaction();
		_connection.Insert(_team);
		_connection.Commit();
	}

	public void updateTeam(Team newTeam)
	{
		_connection.Update(newTeam);
	}

	public List<Team> getTeams()
	{
		_connection.BeginTransaction();
		var Teams = _connection.Table<Team>();
		List<Team> _teams = new List<Team>();
		foreach (var item in Teams) {
			_teams.Add(item);
		}
		_connection.Commit();
		return _teams;
	}

}

حالا دست آخر برای تست کار کردن باید یک کلاس دیگه درست کنم که این ها رو تست کنه من اسمش رو می ذارم Test.cs . پس اول یکسری داده توی دیتابیسمون می ریزم ، با استفاده از DB Browser for SQLite ، بعد توی این کلاس Test  اول لیست تیم ها رو میگیرم ، بعد یک تیم اضافه می کنم ، اطلاعات یک تیم رو آپدیت می کنم و دوباره لیست تیم ها رو چاپ می کنم .

اینم کلاس تست :

using UnityEngine;
using System.Collections;

public class Test : MonoBehaviour {

	public DatabaseHandler dataHandler;

	// Use this for initialization
	void Start () {
		dataHandler = new DatabaseHandler("TestDB");

		Debug.Log("---------------------Teams---------------------");
		var teams = dataHandler.getTeams();
		foreach (var item in teams) {
			Debug.Log(item.ToString());
		}
		Debug.Log("---------------------AddTeam---------------------");
		var team = new Team();
		team.Name = "new Team";
		team.Score = 0;
		dataHandler.addTeam(team);
		Debug.Log("---------------------UpdateScoreOfTeam---------------------");
		teams[1].Score = 200;
		dataHandler.updateTeam(teams[1]);
		Debug.Log("---------------------Teams---------------------");
		teams = dataHandler.getTeams();
		foreach (var item in teams) {
			Debug.Log(item.ToString());
		}

	}

}

سورس فایل ها و پروژه یونیتی کامل