# 7.2. Hướng dẫn Môi trường & Build Source

**Hướng dẫn cài đặt môi trường**

 **Môi trường phát triển hệ điều hành Windows**

\- Cài đặt **IntelliJ IDEA** ( [Link cài đặt Intellij IDEA](https://www.jetbrains.com/idea/download/download-thanks.html?platform=windows)**[ ](https://www.jetbrains.com/idea/download/download-thanks.html?platform=windows)**)

\- Hoặc cài đặt **Visual Studio Code** ( [Link cài đặt Visual Studio Code](https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user) )

\- Cài đặt **JDK-17** ( [Link cài đặt JDK-17](https://download.oracle.com/java/17/archive/jdk-17.0.12_windows-x64_bin.exe) )

Thêm java vào biến môi trường:

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/Greimage.png) ](https://docs.lifetex.vn/uploads/images/gallery/2026-04/Greimage.png)[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/m4Wimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/m4Wimage.png)

\- Cài đặt **Maven** ( [Link tải maven](https://dlcdn.apache.org/maven/maven-3/3.9.14/binaries/apache-maven-3.9.14-bin.zip) )

Giải nén thư mục và thêm vào biến môi trường

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/s28image.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/s28image.png)

Kiểm tra java và maven đã được cấu hình chưa:

```bash
java --version
mvn -v
```

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/Sokimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/Sokimage.png)

1. **Clone mã nguồn & Mở IDE:**
    - Hỗ trợ tốt nhất trên **IntelliJ IDEA.**
    - **Ví dụ sử dụng IDE Visual Studio Code**

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/Jpoimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/Jpoimage.png)

Clone source code: [http://192.168.0.95/nam/signing\_service\_tan\_cang.git](http://192.168.0.95/nam/signing_service_tan_cang.git) nhánh **dev\_namdh\_app\_signing\_desktop**

Mở terminal vscode lên và clone source code về bằng lệnh sau:

```bash
git clone --single-branch --branch dev_namdh_app_signing_desktop http://192.168.0.95/nam/signing_service_tan_cang.git kyso_service 
```

Nhập thông tin tài khoản Gitlab để clone source code về với tên thư mục "**kyso\_service**"

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/3wGimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/3wGimage.png)

Mở thư mục Project **kyso\_service** lên để thực hiện phát triển phần mềm

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/75uimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/75uimage.png)

---

1. - Khi Import, chọn Import theo chuẩn Maven Project tại thư mục Gốc.
2. **Build Dự án Local:** Mở terminal và gõ lệnh: (Bỏ qua Unit Test để tiết kiệm thời gian)
3. ```bash
    mvn clean install -DskipTests
    ```
    
    Build source thành công  
    [![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/FzBimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/FzBimage.png)
4. **Chạy Local Signing Web Service:**

**Với môi trường phát triển là VScode:**

```bash
cd signing-web-service\target
java -jar signing-web-service-0.0.1-SNAPSHOT.jar
```

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/3n1image.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/3n1image.png)

Port mặc địch của định của dịch vụ khi chạy lên là **6868** (Có thể cấu hình chay port khác bằng lệnh sau)

```bash
java -jar signing-web-service-0.0.1-SNAPSHOT.jar --server.port=<port_service>
```

**Với môi trường phát triển là IntelliJ IDEA**

1. - Trỏ IDE vào thư mục module `signing-web-service`.
    - Tìm Main class `SigningWebServiceApplication.java` và thiết lập Run Configuration.
2. [![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/jS8image.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/jS8image.png)
3. - **Chú ý:** Web Service cần có cấu hình `application.yml` trỏ đúng vào CSDL và Server Redis (Trường hợp không có DB thật, có thể dựng Docker Container Redis &amp; SQL Server Local trước khi chạy).
4. **chạy thành công**

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-04/scaled-1680-/toVimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-04/toVimage.png)

1. **Chạy Local Signing Desktop (Cổng 6868):**
    - Trỏ IDE vào thư mục module `signing-desktop`.
    - Chạy class `SigningDesktopApplication.java`. (Ứng dụng chạy Swing UI, cần gắn thử một USB Token thật vào máy để test tính năng Load Danh sách chứng thư).