在Ubuntu下搭建ASP.NET 5開發環境

durow發表於2015-12-27

在Ubuntu下搭建ASP.NET 5開發環境

0x00 寫在前面的廢話

年底這段時間實在太忙了,各種事情都湊在這個時候,沒時間去學習自己感興趣的東西,所以部落格也好就沒寫了。最近工作上有個小功能要做成Web應用,之前曾經有過類似需求,當時用的是WCF做WebAPI,前端用ExtJS。這次需求不關鍵,只要能解決問題就好,具體用什麼技術無所謂,正好趕上ASP.NET 5釋出,所以打算嘗試一下。在Windows下藉助強大的VS一路安裝就解決問題了,不過ASP.NET5跨平臺啊,決定試一下在Linux下部署開發環境,以後再忽悠別人入坑也更有說服力。之前一直用Windows,只是出於好奇裝過Linux,所以對Linux不是很熟系,邊查邊做,期間自然是各種坑,折騰了一天多,不過最後也算跑起來了,在這裡記錄一下踩到的坑和解決的以及未解決的問題。

0x01 Windows和Ubuntu雙系統

之前都使用虛擬機器裝Linux的,這次既然要測試就認真一點吧,從硬碟中劃出了100G的空間,參照網上的教程裝了Ubuntu雙系統。不過這個不是本文的重點,而且很容易就能搜到大量教程,具體就不說了。我參考的這篇文章:
http://www.linuxidc.com/Linux/2012-05/59663.htm

0x02 安裝ASP.NET 5開發環境

下面重點開始了,主要步驟參照的微軟的官方文件:
https://docs.asp.net/en/latest/getting-started/installing-on-linux.html
首先說明一下踩到的第一個坑,因為很多命令都需要用到sudo,所以我乾脆sudo bash把終端切換到了root,造成的後果就是後面建立的有些資料夾都是root的,導致後來在非root下用yo建立專案的時候出現許可權錯誤,花了很多時間才找到問題。所以為了少出現不必要的麻煩下面操作時建議大家還是老老實實用sudo。下面截圖中可以看到我還是用的root,大家不要這樣。

1 安裝DNVM

首先準備開發環境搭建用到的工具。一般來說很可能系統自帶了,不過以防萬一還是執行一下,反正也很快:

sudo apt-get install unzip curl

這個命令會安裝unzip和curl兩個工具,用於解壓和下載
什麼是DNVM、DNX可以參照@張善友 的這篇文章http://www.cnblogs.com/shanyou/p/4589930.html 寫的很全面
然後下載DNVM。官網文件給出了以下命令:

curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh

這裡就用到剛剛準備好的curl了,不過一般系統都自帶了。

按照系統提示在下載完後執行命令

source ~/.dnx/dnvm/dnvm.sh

這樣DNVM就安裝完成了。可以輸入dnvm看是否安裝成功。

2 使用DNVM安裝DNX

首先還是需要準備安裝中用到的工具

sudo apt-get install libunwind8 gettext libssl-dev libcurl4-openssl-dev zlib1g libicu-dev uuid-dev

然後用DNVM安裝DNX for.NET Core

dnvm upgrade -r coreclr

然後使用DNVM安裝DNX for Mono

dnvm upgrade -r mono

安裝時提示我的系統裡沒有Mono,需要安裝。參照官網文件給出的連結,依次執行以下命令:

apt-key adv --keyserver keyserver.ubuntu.com –recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb http://download.mono-project.com/repo/debian wheezy main" |  tee /etc/apt/sources.list.d/mono-xamarin.list
apt-get update
apt-get install Mono-Complete 

3 安裝libuv

為什麼要安裝這個東西呢,因為開發中需要執行本地Web服務測試啊,在Windows中我們有IIS Express,可是Linux中沒有。官方推薦使用的是kestrel,而kestrel用到了libuv這個庫,所以我們需要安裝這個庫。這個庫是用原始碼編譯的方式安裝的,命令比較多,反正我是一行一行復制著完成的,基本上覆制完下一條命令的時間上一條命令就執行完成了,體驗也算不錯:)大致的過程就是:安裝編譯需要的工具,下載並解壓原始碼,編譯安裝,載入共享庫使新庫生效。

sudo apt-get install make automake libtool curl
curl -sSL https://github.com/libuv/libuv/archive/v1.4.2.tar.gz | sudo tar zxfv - -C /usr/local/src
cd /usr/local/src/libuv-1.4.2
sudo sh autogen.sh
sudo ./configure
sudo make
sudo make install
sudo rm -rf /usr/local/src/libuv-1.4.2 && cd ~/
sudo ldconfig

至此我們已經完成ASP.NET 5 開發環境的安裝了。這樣是不是就結束了呢?剛開始我也是這麼想的,不過馬上就意識到不對了。當我想建個測試工程的時候發現無法入手,在Windows上我都是用VS新建解決方案,選擇Web,然後選擇用什麼樣的模板,可是在Linux下沒有模板啊,總不能手動一個一個檔案建立吧。然後繼續看文件找到原來還有Your First APS.NET 5 Application on XXX系列,不過裡面沒有Linux,參照Mac應該也沒問題。
https://docs.asp.net/en/latest/tutorials/your-first-mac-aspnet.html

0x03 安裝和配置開發工具

開發工具自然是Visula Studio Code,官網下載
https://code.visualstudio.com/
下載後解壓,直接執行Code即可使用。
建立專案時的模板是通過yeoman生成的。安裝yeoman需要用npm,於是我們先安裝npm

sudo apt-get install npm

npm和nodejs是相互依賴的,安裝其中任意一個都會自動安裝上另外一個。安裝後可以使用

npm install -g yo bower grunt-cli gulp

來安裝yeoman、bower、grunt-cli、gulp。不過問題來了,yeoman需要nodejs版本在0.12以上,而用apt-get安裝的版本只是0.10,各種折騰都升級不了,包括使用傳說中的n這個名字怪異但據說是專用於升級nodejs的工具都不行。在網上查來查去找到了這邊文章:
http://my.oschina.net/tbaby/blog/412052
裡面有這麼一條命令:

curl --silent --location https://deb.nodesource.com/setup_0.12 | sudo bash -

開啟 https://deb.nodesource.com看了下我擦原來在這裡


執行上面那條命令下載完成後還會提示


執行這條命令

sudo apt-get install nodejs

就可以安裝最新版本的nodejs了。安裝完成後已經成了最新的0.12.9


這樣再使用npm安裝yeoman等一系列工具就沒有問題了,命令如下:

npm install -g yo bower grunt-cli gulp

yeoman是裝好了,不過yeoman還不能生成針對ASP.NET的模板,這個也是需要我們安裝的。使用以下命令來安裝ASP.NET模板:

npm install -g generator-aspnet

安裝完成後我們就可以使用yeoman建立工程了。進入我們想放置工程的目錄,執行

yo aspnet

然後我們就看到了模板選擇介面,我們選擇WebApplication,然後會提示我們輸入應用的名稱,我們輸入first,然後yeoman會幫我們建立first這個目錄,然後把專案檔案都建立好。

使用VSCode開啟first目錄會提示缺少依賴


在工程所在目錄下執行下面命令

dnu restore

這樣就可以解決依賴的問題。如果是第一次restore要下載很多東西可能會花點時間。
完成之後目錄結構大概就是這樣,跟用VS建立的一致。程式碼也會有屬性和方法的引用提示。

在工程的project.json檔案中我們可以看到commands中友web這個命令,在dependency中我們也能找到相應的依賴。使用web這個命令就能開啟kestrel服務。

在工程所在目錄下執行

dnx web

可以開啟web服務,這樣在瀏覽器中輸入localhost:5000就能看到我們的頁面了。

嘗試把HomeController中About的訊息改一下。必須要重啟Web服務才能生效,這點不如用VS啊,VS可以直接改了儲存然後F5重新整理就能看效果,跟用指令碼開發一樣。


比較奇怪的是把dnx切換到coreclr後輸入dnx沒有任何反映,網上查也沒看到問題出在哪裡。有知道的請賜教。

------------=-------   21月28日更新   ----------------------

感謝@zwmyxzs給出的解決方案,@zwmyxzs之前寫過關於這個問題的文章: ubuntu15 coreclr

因為coreclr適配的Ubuntu14,我用的Ubuntu15,unbuntu14是用的libicu52,而unbuntu15是libicu55,所以只要裝個libicu52即可。

wget http://security.ubuntu.com/ubuntu/pool/main/i/icu/libicu52_52.1-8ubuntu0.2_amd64.deb
dpkg -i libicu52_52.1-8ubuntu0.2_amd64.deb

按照@zwmyxzs 給的方法成功。

用coreclr執行服務正常

0x04 寫在最後的廢話

由於對Linux不是很熟悉,整個過程遇到了很多大大小小的問題,我挑了幾個比較惱人的寫了下。還有些弱智到會暴露智商的我都沒提,這樣才夠心機。不過完成後對dnvm、dnx等很多概念有了更多的認識。但讓我做ASP.NET 5開發的話我還是會選擇windows啊,畢竟親生的還有強大的VS。最後再說一下Ubuntu的使用,之前一直使用Windows,突然換到了Ubuntu感覺沒有想象中的那麼困難,圖形介面也算比較成熟了,很多工具用Web應用基本可以解決。開發的話JetBrains系列都可以使用,加上現在還多了VSCode,只要不寫WPF感覺問題都不是很大。遇到問題了網上搜一下基本也都能解決,慢慢就應該能熟練了吧。

 


更多內容歡迎訪問我的部落格:http://www.durow.vip

相關文章