数据是任何应用程序开发的一个重要组成部分,移动应用程序也不例外;作为开发人员,处理数据是我们的一个重要决策,对移动应用开发也是如此。从键值对存储到SQLite,有许多选项可用,但是,.NET开发者往往特别熟悉的是实体框架。
实体框架是一个对象/关系映射(O/RM),它允许.NET开发人员使用.NET对象处理数据库,从而消除了开发人员通常需要编写的更多数据访问代码的需要。实体框架很棒,但在实体框架核心出现之前,在移动开发项目中很难使用。实体框架核心是一种轻量级的、可扩展的跨平台版本的实体框架数据访问技术。
什么是实体框架核心?
E实体框架核心(EF核心)与全面实体框架相比引入了许多新特性和改进,但完全是一个全新的代码库,跨平台的应用程序的优化。如果你有实体框架的经验,你会发现EF核心很熟悉。尽管它并不是所有的特性都相同,但是在将来的版本中会出现很多特性(比如延迟加载和连接弹性)。因为EF核心与.NET标准兼容,我们现在可以Xamarin.Android中使用。
由于它的易用性,在相当长的一段时间里EF的核心一直是我最喜欢的项目。挑战始终是,“我如何Xamarin程序中使用实体框架?“在这个博客文章中,我将向您展示如何通过使用支持实体框架的核心数据库来构建一个Android应用程序。
入门
创建.NET标准库
开始入门,让我们创建一个.NET标准库。NET是一个正式的规范.NET API的标准,目的是让.NET API可以运行与所有网络运行环境,类似于可移植类库。这个库是我们放置所有共享应用程序代码的地方,包括我们的实体框架核心逻辑。
新创建一个解决方案,添加一个便携式类库(PCL)到解决方案中。
因为这不是一个.NET标准(netstandard)类库,我们可以通过右键单击项目并导航到属性来转换它:
根据NuGet,Microsoft.EntityFrameworkCore和Microsoft.EntityFrameworkCore.Sqlite要求的包指定库需要指向netstandard 1.3。我们在同一个地方改变目标:
然后我们需要添加实体框架包装我们的项目。右击References文件夹,选择Manage NuGet Packages…,并安装 Microsoft.EntityFrameworkCore和Microsoft.EntityFrameworkCore.Sqlite包。
太伟大了!现在我们开始进入编写一些实体框架代码。
定义DbContext
如果您以前使用过实体框架,你会非常熟悉如何定义一个DbContext和我们的基本模型,定义我们的数据库架构。
L让我们用一个简单的数据模型,我们叫Cat开始。
using System.ComponentModel.DataAnnotations; using System.Threading.Tasks; ... public class Cat { [Key] public int CatId { get; set; } public string Name { get; set; } public int MeowsPerSecond { get; set; } }
接下来,让我们确保我们的Cat类是DbContext的一部分,并且是通过定义一个新的上下文CatContext。
using Microsoft.EntityFrameworkCore; ... public class CatContext : DbContext { public DbSet Cats { get; set; } private string DatabasePath { get; set; } public CatContext() { } public CatContext(string databasePath) { DatabasePath = databasePath; } protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseSqlite($"Filename={DatabasePath}"); } }
Using Entity Framework Core with 在Xamarin.Android中使用
入门
现在,在包含EF核心的.NET标准库中,我们配置了数据库配置,让我们创建一个Android项目来连接数据库。右击解决方案,点击Add Project,并选择Single-View App (Android).
就像以前一样,我们需要添加
Microsoft.EntityFrameworkCore和Microsoft.EntityFrameworkCore.SqliteNuGet包到我们的Android项目。
实施背景
首先,我们需要确保我们的Xamarin.Android项目引用我们的.NET标准库。 在Android项目中,右击References文件夹,选择Add Reference…,,然后选择我们在博客开始时创建的库。点击OK来保存reference。
现在我们有了库, 让我们在MainActivity.cs中实现某些实体框架代码!
using System.IO; using Microsoft.EntityFrameworkCore; using System.Diagnostics; using EntityFrameworkWithXamarin; using EntityFrameworkWithXamarin.Core; using System.Collections.Generic; ... [Activity(Label = "EntityFrameworkWithXamarin.Droid", MainLauncher = true, Icon = "@drawable/icon")] public class MainActivity : Activity { int count = 1; protected async override void OnCreate(Bundle bundle) { base.OnCreate(bundle); // Set our view from the "main" layout resource SetContentView(Resource.Layout.Main); // Get our button from the layout resource, // and attach an event to it Button button = FindViewById
现在添加TextView1到我们的Resources > Layout > Main.axml中,在MainActivity中我们会使用它。
下一步,设置我们的Android项目为启动项目并在模拟器中运行,哎呀,看来我们会得到一个错误:
Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 1: 'no such table: Cats'.
生成EF核心迁移
我们缺少一个叫做Migrations的核心实体框架功能,它创建数据库架构。此刻,没用从Xamarin.Android项目或者.NET标准库中生成实体框架Migrations的一个重要途径。让我们使用一个快速的解决方法,它通过创建一个新的netcore控制台应用来生成Migrations。
为产生Migrations,请添 Microsoft.EntityFrameworkCore.Tools.DotNet,Microsoft.EntityFrameworkCore.Design,和Microsoft.EntityFrameworkCoreNuGet包到项目中,我们可以使用命令行来生成Migrations。
注: Microsoft.EntityFrameworkCore.Tools.DotNet 目前抢鲜版,你需要在NuGet包管理器中选中Include prerelease复选框,如果你之前没有选中的话。
现在我们需要将Cat和CatContext移动过去,确保DbContext能产生Migrations。现在我们能生成我们的内容的一个架构,让我们使用新的dotnet工具来完成。在我们当前的控制台应用目录打开一个新的控制台:
运行命令生成Migration:
dotnet ef migrations add Initial
我们看到下面的输出:
现在我们需要进行我们的项目迁移文件夹中生成的初始迁移,并将它们移到.NET标准库中。
注意:你可以简单的改变这两个生成的文件到你的netstandard命名空间的命名空间的名称。
把它们放在一起
再次运行Xamarin.Android项目,现在我们可以在我们的Android应用成功使用实体框架核心来存储数据!
我们可以仔细看看,通过打开Android设备监控器,得到使用模拟器生成的SQLite文件。查找data/data/files文件夹,我们看到创建了Cats.db数据库文件。
我们可以使用一些SQLite浏览器工具选择文件来打开它,点击Pull a file from the device,并保存到本地,如下使用SQLite DB浏览器来查看数据。
结束语
在这篇博客文章中,我们在Xamarin.Android应用中使用实体框架核心来生成一个数据库,查看实体框架核心文件。你可以在我的GitHub上抓住我的全部源代码来使用实体框架构建Android应用。