Đã đăng vào khoảng 21 giờ trước 4 phút đọc

Hướng dẫn khởi tạo và Import dự án Book Store với EzyPlatform vào IntelliJ IDEA

Trong kiến trúc của EzyPlatform, việc khởi tạo dự án và thiết lập môi trường là bước nền tảng quyết định tính ổn định của quy trình phát triển. Tài liệu này hướng dẫn chi tiết các bước từ CLI đến việc đồng bộ hóa dự án vào IntelliJ IDEA và xử lý các vấn đề dependency thường gặp.

1. Yêu cầu chuẩn bị

Để đảm bảo tính đồng nhất của môi trường phát triển (Development Environment), máy trạm cần đáp ứng:

JDK: Phiên bản tương thích với dự án (khuyến nghị JDK 8 hoặc 11+).
IntelliJ IDEA: Đã được cài đặt sẵn sàng.
EzyPlatform SDK: Đã cấu hình biến môi trường EZYPLATFORM_HOME trỏ đúng đường dẫn gốc.

2. Khởi tạo cấu trúc dự án

Sử dụng CLI để đảm bảo cấu trúc thư mục tuân thủ chặt chẽ quy chuẩn của Framework.

Bước 1: Thiết lập không gian làm việc

Mở CMD hoặc Terminal, di chuyển đến phân vùng lưu trữ dự án:

E:
cd E:\Workspaces\CompanyProjects

Bước 2: Generate dự án từ Core SDK

Sử dụng lệnh ezy.bat (Windows) hoặc ezy.sh (Linux/Mac) để sinh mã nguồn:

Bash
ezy.bat cp book-store -g com.company.group -p com.company.book_store -v 1.0.0

Chi tiết tham số:

cp Lệnh khởi tạo Create Project.

book-store: Tên định danh Artifact của dự án.

-g: Group ID của tổ chức.

-p: Package Name gốc. Cần đặt chính xác để tránh refactor về sau.

-v: Version khởi tạo.

Khi hệ thống trả về thông báo Completed, project dir: book-store, quá trình khởi tạo cấu trúc vật lý đã hoàn tất.

3. Import và Đồng bộ hóa trên IntelliJ IDEA

Bước 1: Load Project

Trên IntelliJ, chọn File -> Open.
Trỏ đường dẫn đến thư mục book-store vừa khởi tạo, nhấn Select Folder.

Bước 2: Cấu hình Project Structure

Bước bắt buộc để IDE nhận diện đúng ngữ cảnh biên dịch:

Truy cập File -> Project Structure.
Tại mục Project SDK: Chọn phiên bản JDK đã chuẩn bị ở phần 1.

Đảm bảo Project language level tương thích với SDK.

Bước 3: Resolve Dependencies

Để các module liên kết được với nhau, cần thực hiện build qua Maven:

Mở tab Maven bên phải màn hình.
Mở rộng cây thư mục dự án book-store -> Lifecycle.
Click đúp vào install.

Lệnh này sẽ đóng gói các file .jar và đưa vào Local Repository, giúp các module con nhận diện được dependency lẫn nhau.

4. Xử lý xung đột phiên bản

Đây là vấn đề thường gặp khi tích hợp các plugin có sẵn như ezyarticle vào dự án mới, do sự sai lệch giữa mã nguồn mẫu và môi trường thực tế.

Triệu chứng: Khi build hoặc export gặp lỗi: Could not resolve dependencies... Could not find artifact ...:jar:0.0.1.
Nguyên nhân: File pom.xml khai báo phiên bản cũ (ví dụ 0.0.1), trong khi thư viện thực tế trong EzyPlatform đã cập nhật (ví dụ 0.0.5).
Quy trình xử lý:
Kiểm tra thực tế: Truy cập đường dẫn ezyplatform/admin/plugins/ezyarticle/lib (hoặc tên plugin tương ứng). Kiểm tra phiên bản file .jar hiện hữu.
Đồng bộ cấu hình: Mở file pom.xml hoặc module.properties của dự án. Cập nhật tham số version khớp với file thực tế vừa kiểm tra:

XML
<properties>
    <ezyarticle.version>0.0.5</ezyarticle.version>
</properties>

Re-build: Chạy lại lệnh install trong Maven để cập nhật dependency.

5. Kiểm thử hoạt động

Sau khi hoàn tất cấu hình, thực hiện chạy thử để xác nhận hệ thống sẵn sàng.

Tại cây thư mục dự án, tìm đến module: book-store-theme.
Truy cập: src -> test -> java -> <package>.book_store.web.test
Chạy Class: BookStoreThemeStartupTest.

Kết quả mong đợi: Console hiển thị log:

EZYHTTP READY

Tín hiệu này xác nhận Server đã khởi động, các cổng kết nối đã được lắng nghe và toàn bộ thư viện đã nạp đúng phiên bản. Dự án sẵn sàng cho giai đoạn phát triển nghiệp vụ.