原文:http://stephenwalther.com/archive/2015/02/03/asp-net-5-and-angularjs-part-7-running-on-a-mac
这篇文章中, 我会把之前的ASP.NET 5 项目在我的Mac上运行起来.
安装 Mono
首先你得安装Mono. Mono项目独立于Microsoft. Mono是一个.NET运行在Mac OSX和Linux上的开源实现.
http://www.mono-project.com/download/
安装Mono非常方便、友好.
更新 Homebrew
下一步是使用Homebrew 安装 KVM. 在这一步我遇到了几个问题.
第一个问题是Ruby在Yosmite上的位置发生了改变, 这导致了Homebrew不能工作:
http://apple.stackexchange.com/questions/153790/how-to-fix-brew-after-its-upgrade-to-yosemite
我执行下面的命令更新Homebrew, 这样Homebrew就能在OSX Yosemite工作了:
cd /System/Library/Frameworks/Ruby.framework/Versions sudo ln -s Current 1.8 sudo brew update sudo rm 1.8
安装KVM
Homebrew能正常工作后, 使用Homebrew安装ASP.NET 5 KVM. 首先, 你需要运行下面的命令让aspnet/k GitHub repository 和 Homebrew 关联起来:
下一步, 运行下面的命令安装kvm:
brew install kvm
运行后, 我遇到了一个错误kvm 已安装, 但是“just not linked”. 执行下面的命令修复这个问题:
sudo brew link kvm
执行下面的命令验证kvm和Mono是否安装正常:
kvm list
在运行kvm或k命令前, 你需要运行下面的命令:
source kvm.sh
每次你打开Terminal的时候都需要运行一次这个命令, 这样Terminal才知道去哪找kvm和k.
安装Movies App
下一步, 我从GitHub repository获取Movies app的源代码, 执行下面的命令:
git clone https://github.com/StephenWalther/MovieAngularJSApp.git
在Mac上我使用Sublime Text作为.Net App的编辑器.
使用In-Memory数据库
Movies App使用的是EF7和Microsoft SQL Server. Microsofe SQL Server不能在Mac上运行.
关于数据库你有下面的选择:
- SQLite – SQLite是一个开源的数据库, 可以运行在Windows, Windows Phone, OSX, Linux上. .
- Azure SQL Database – 把你的数据库部署在云端.
- In-Memory – 使用内存数据库 (注意了一重启web服务数据就全丢了).
我不能让SQLite在ASP.NET 5 的BETA版本上工作起来. 找不到UseSQLite()方法, 我猜可能是这个SQLite的Provider还没有支持BETA版本的ASP.NET 5.
使用Azure SQL Database对于真实应用来说是一个最好的选择.
我选择在这个例子中使用In-Memory数据库.
为了Movies app使用In-Memory Provider我要做2处修改. 首先, 我要在project.json文件的dependencies section中添加EntityFramework.InMemory的引用.
然后, 修改Startup类. 修改Startup.cs中的ConfigureServices()方法检查是否运行在Mono (OSX 或 Linux)环境下. 当Movies app运行在Mono环境下,使用In-Memory provider. 否则, 使用 Microsoft SQL Server.
public void ConfigureServices(IServiceCollection services) { //Sql client not available on mono var usingMono = Type.GetType("Mono.Runtime") != null; // Add EF services to the services container if (usingMono) { services.AddEntityFramework(Configuration) .AddInMemoryStore() .AddDbContext<MoviesAppContext>(); } else { services.AddEntityFramework(Configuration) .AddSqlServer() .AddDbContext<MoviesAppContext>(options => { options.UseSqlServer(Configuration.Get("Data:DefaultConnection:ConnectionString")); }); } // add ASP.NET Identity services.AddIdentity<ApplicationUser, IdentityRole>(Configuration) .AddEntityFrameworkStores<MoviesAppContext>(); // add ASP.NET MVC services.AddMvc(); }
更新Startup类的CreateSampleData() 方法. 只有运行在windows上才调用EnsureCreatedAsync()创建数据库. 当使用In-Memory provider的时候不需要创建数据库文件.
private static async Task CreateSampleData(IServiceProvider applicationServices) { using (var dbContext = applicationServices.GetService<MoviesAppContext>()) { // ensure SQL Server database created var sqlServerDatabase = dbContext.Database as SqlServerDatabase; if (sqlServerDatabase != null) { sqlServerDatabase.EnsureCreatedAsync().Wait(); } // add some movies var movies = new List<Movie> { new Movie {Title="Star Wars", Director="Lucas"}, new Movie {Title="King Kong", Director="Jackson"}, new Movie {Title="Memento", Director="Nolan"} }; movies.ForEach(m => dbContext.Movies.AddAsync(m)); // add some users var userManager = applicationServices.GetService<UserManager<ApplicationUser>>(); // add editor user var stephen = new ApplicationUser { UserName = "Stephen" }; var result = await userManager.CreateAsync(stephen, "[email protected]"); await userManager.AddClaimAsync(stephen, new Claim("CanEdit", "true")); // add normal user var bob = new ApplicationUser { UserName = "Bob" }; await userManager.CreateAsync(bob, "[email protected]"); } }
使用Kestrel
无法在OSX下使用IIS. 在OSX下你需要使用Kestrel web服务器, 这个是ASP.NET团队开发的.
Under the covers, Kestrel is built on top of Libuv, which is also used by NodeJS. You can read about Libuv here:
http://nikhilm.github.io/uvbook/
为了使用Kestrel, 你需要在project.json文件中添加kestrel依赖. 下面是我完整的依赖section:
"dependencies": { "Kestrel": "1.0.0-*", "EntityFramework.InMemory": "7.0.0-*", "EntityFramework.SqlServer": "7.0.0-beta2", "EntityFramework.Commands": "7.0.0-beta2", "Microsoft.AspNet.Mvc": "6.0.0-beta2", /* "Microsoft.AspNet.Mvc.WebApiCompatShim": "6.0.0-beta2", */ "Microsoft.AspNet.Diagnostics": "1.0.0-beta2", "Microsoft.AspNet.Diagnostics.Entity": "7.0.0-beta2", "Microsoft.AspNet.Identity.EntityFramework": "3.0.0-beta2", "Microsoft.AspNet.Security.Cookies": "1.0.0-beta2", "Microsoft.AspNet.Server.IIS": "1.0.0-beta2", "Microsoft.AspNet.Server.WebListener": "1.0.0-beta2", "Microsoft.AspNet.StaticFiles": "1.0.0-beta2", "Microsoft.Framework.ConfigurationModel.Json": "1.0.0-beta2", "Microsoft.Framework.CodeGenerators.Mvc": "1.0.0-beta2", "Microsoft.Framework.Logging": "1.0.0-beta2", "Microsoft.Framework.Logging.Console": "1.0.0-beta2", "Microsoft.VisualStudio.Web.BrowserLink.Loader": "14.0.0-beta1" },
获取 NuGet Dependencies
在运行Movies app之前, 我们需要从NuGet下获取到project.json文件中定义的依赖. 执行下面的命令:
kpm restore
运行Kestrel
执行下面的命令:
k kestrel
执行上面的命令会开始启用 Kestrel web 服务器.
Kestrel默认的端口为5104. 你可以在project.json文件中的commands section中看到kestrel是使用的哪个端口.
打开:
你可以用 Stephen 或 Bob登陆 (密码为 [email protected]).
停用 Kestrel
停用Kestrel出奇意外的麻烦. 在OSX里, 在终端CTRL-C不会做任何事情, 也不会停止服务. 下面是我的步骤:
- CTRL-Z停止Kestrel.
- 输入 ps 获取到所有进程.
- 输入 kill process id 结束Mono进程.
下面是StackOverflow对这个问题的讨论:
http://stackoverflow.com/questions/25712814/how-to-quit-asp-net-kestrel-web-server-on-a-mac