HƯỚNG DẪN BUILD HIS NGUỒN MỞ TỪ BỘ SOURCE CODE - Vietsens/hisnguonmo GitHub Wiki
Tải các thành phần source code của His nguồn mở
-
Clone source code từ git: mở windows powershell và thực hiện chạy các lệnh sau
Tạo sẵn folder HISNGUONMO để lưu source code tải về và chạy lệnh bên dưới để clone về máy
git clone https://github.com/Vietsens/hisnguonmo.git
Tải các thư viện bản build sẵn với phiên bản tương thích về lưu trong folder LIB ở trên máy
$zipUrl = "http://fsstest.onelink.vn/Upload/HIS/HisNguonMo/lib_extend.zip" $zipPath = "E:\HisNguonMo\hisnguonmo\lib\lib_extend.zip" $extractPath = "E:\HisNguonMo\hisnguonmo\lib" # Tải file zip Invoke-WebRequest -Uri $zipUrl -OutFile $zipPath # Giải nén file zip Expand-Archive -Path $zipPath -DestinationPath $extractPath # Xóa file zip sau khi giải nén Remove-Item -Path $zipPath
-
Sau khi clone các git cần thiết về tổ chức folder theo cây folder như sau:
++ hisnguonmo
++++++++ HIS
++++++++ UC
++++++++ MPS
++++++++ Common
++ lib
Cách thức build
Sử dụng bộ công cụ Microsoft Build Engine(MSBuild) là một nền tảng để xây dựng và build các ứng dụng, là bộ công cụ mã nguồn mở và miễn phí của Microsoft (https://en.wikipedia.org/wiki/MSBuild).
Có thể dùng cmd của windows hoặc visual studio code để chạy các lệnh build
Nếu sử dụng visual studio code cần cấu hình thêm môi trường thực thi lệnh như sau: nhấn env vào ô search của windows
Sau đó nhấn vào: Environment variables.. -> vùng system vaiable chọn dòng có varable là path và nhấn nút edit -> nhập thêm path đến path của .net version được cài đặt trên máy
Vd: C:\Windows[Microsoft.NET](http://microsoft.net/)\Framework\v4.0.30319 với windows 32 bit
hoặc C:\Windows[Microsoft.NET](http://microsoft.net/)\Framework64\v4.0.30319 với windows 64 bit
Cài đặt .net framework:
https://www.microsoft.com/en-us/download/details.aspx?id=42642
Build
Với command prompt(cmd) tool của windows
Tìm và nhảy vào folder Microsoft.Net framework đã cài đặt trên máy tính,
Vd: C:\Windows\Microsoft.NET\Framework\v4.0.30319
cd C:\Windows\Microsoft.NET\Framework\v4.0.30319
Tiếp theo gõ lệnh build sử dụng MSBuild.exe:
MSBuild.exe E:\HisNguonMo\Desktop\HIS\HIS.Desktop\HIS.Desktop.csproj /p:Configuration=Release /p:Platform=AnyCPU /p:TargetFrameworkSDKToolsDirectory="C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools"
Lưu ý: cần sửa lại tham số cấu hình trong lệnh build cho khớp với môi trường thực tế của máy tính
Trong đó
-
E:\HisNguonMo\Desktop\HIS\HIS.Desktop\HIS.Desktop.csproj là đường dẫn đến file cs project của main project his nguồn mở đã tải về
-
/p:Configuration=Release: chọn cấu hình build: Debug|Release
-
/p:Platform=AnyCPU: chọn flatform để build: AnyCPU|x86|x64
-
/p:TargetFrameworkSDKToolsDirectory="C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools": chọn đường dẫn SDKTools
Với visual studio code
Mở visual studio code -> terminal -> chọn folder His.Desktop
Sau đó gõ lệnh build:
MSBuild.exe HIS.Desktop.csproj /p:Configuration=Release /p:Platform=AnyCPU /p:TargetFrameworkSDKToolsDirectory="C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools"
Tổ chức lại folder chạy của dự án
Sau khi build xong tổ chức lại folder chạy của dự án như sau:
Copy các thành phần đã build của phiên bản product tương ứng với bộ source code gồm: folder en, vi, Img, x64, x86, Plugins, Tmp,…
Các file ConfigSystem.xml, APP.ico,… vào bộ source code đã build ra
Sau đó xóa các file dư thừa .pdb và đồng thời copy các file dll bên ngoài vào folder ReferencedAssemblies chỉ để lại 1 số file theo cấu trúc như sau
Build và release các module tính năng
Sau khi chỉnh sửa sourcode của tính năng vd chức năng kê đơn, cần build tính năng để có được file trong folder Debug hoặc Release tùy vào cấu hình của project
Thực hiện copy file dll vào bản build của phần mềm HIS đè vào file cùng tên trong folder Plugins\Module
Build và release các tính năng in ấn
Mở source code của các tính năng in ấn
Thực hiện chỉnh sửa code theo nhu cầu
Build project ra file dll
Copy dll vào bản build của phần mềm HIS đè vào file cùng tên trong folder Plugins\MpsProcessor
Build và release các thành phần màn hình phụ
Mở project sourcode của màn hình phụ vd:
Thực hiện chỉnh sửa code theo nhu cầu
Sau khi chỉnh sửa xong build source code ra file dll
Thực hiện copy file dll vào bản build của phần mềm HIS đè vào file cùng tên trong folder ReferencedAssemblies