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 1

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

3

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