【Xamarin.Android】使用实体框架构建Android应用程序

数据是任何应用程序开发的一个重要组成部分，移动应用程序也不例外；作为开发人员，处理数据是我们的一个重要决策，对移动应用开发也是如此。从键值对存储到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…，并安装 和包。

太伟大了!现在我们开始进入编写一些实体框架代码。

定义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).

就像以前一样，我们需要添加
和NuGet包到我们的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，请添 ，，和NuGet包到项目中，我们可以使用命令行来生成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，并保存到本地，如下使用 DB浏览器来查看数据。

结束语

在这篇博客文章中，我们在Xamarin.Android应用中使用实体框架核心来生成一个数据库，查看实体框架核心文件。你可以在我的抓住我的全部源代码来使用实体框架构建Android应用。