Hướng dẫn chi tiết từng bước xây dựng dự án trên nền tảng EzyPlatform

1. Cài đặt Java 8

Để bắt đầu, bạn cần tải và cài đặt Java 8. Hãy truy cập vào link cài đặt Java 8 và lựa chọn file cài đặt phù hợp với hệ điều hành của bạn. Sau khi tải về và cài đặt, mở Command Prompt và sử dụng lệnh:

java -version

Nếu xuất hiện thông tin phiên bản Java, bạn đã cài đặt thành công.

2. Thiết lập Biến Môi Trường JAVA_HOME

Mở Windows Search và gõ Edit the system environment variables. Tại cửa sổ System Properties, chọn Environment Variables. Ở phần System variables, nhấn New để tạo biến mới. Đặt tên biến là JAVA_HOME và dẫn đến thư mục của JDK 8 mà bạn đã cài đặt. Nhấn OK để hoàn tất.

3. Cài đặt EzyPlatform

3.1. Tải về và cài đặt EzyPlatform

Truy cập vào EzyPlatform và tải SDK về. Sau khi tải xong, hãy giải nén file để sử dụng.

3.2. Tạo Biến Môi Trường Cho EzyPlatform

Tương tự như trong bước 2, bạn cần tạo một số biến môi trường cho EzyPlatform:

• EZYPLATFORM_HOME: dẫn đến thư mục bạn vừa tải về; ví dụ: C:\Users\duong\Downloads\ezyplatform-0.2.4\ezyplatform
• EZYPLATFORM_SDK: dẫn đến thư mục SDK mà bạn đã tải; ví dụ: C:\Users\duong\Downloads\ezyplatform-sdk-0.0.9\ezyplatform-sdk

Cuối cùng, thêm đường dẫn mới vào biến PATH bằng cách chọn Edit -> New -> thêm '%EZYPLATFORMSDK%\bin' và nhấn OK.

4. Khởi Tạo Database

Sử dụng MySQL Workbench hoặc các phần mềm quản lý MySQL khác để khởi tạo database. Tạo một schemas mới có tên là ezplatform với charset/collation là utf8 và utf8_bin. Nhấn Apply để thực hiện.

Lưu ý: Hãy đảm bảo sử dụng tài khoản SQL có mật khẩu!

5. Cấu Hình Thông Tin Nguồn

Mở file setup.properties trong thư mục EzyPlatform đã giải nén và cấu hình thông tin cho user cùng tên database là ezplatform. Sau đó, nhấn Ctrl + S để lưu lại.

6. Chạy Thử Chương Trình

Mở Command Prompt và dẫn đến thư mục EzyPlatform đã tải. Sử dụng lệnh:

.\cli.bat "console admin"

Nếu hiển thị EZYHTTP READY thì chương trình đã chạy thành công. Nếu có lỗi xảy ra, hãy kiểm tra lại thông tin datasource cho database. Sau khi chạy thành công, bạn có thể truy cập vào URL: http://localhost:9090/setup-admin để tạo tài khoản admin và đăng nhập.

7. Tạo Mới Theme

Tại trang admin, chọn mục Theme trong phần COMPONENT của sidebar. Chọn theme phù hợp cho dự án. Để tạo dự án khóa học, hãy chọn Create new → chọn ELearning → cài đặt các plugin cần thiết và chọn Active. Sau khi plugin được kích hoạt, mở Command Prompt mới và chạy lệnh sau trong thư mục EzyPlatform:

.\cli.bat "console web"

Chờ cho ứng dụng khởi chạy và hiển thị EZYHTTP READY, sau đó truy cập vào URL: http://localhost:8080/ để thiết kế trang của bạn theo mong muốn.

8. Tạo Dự Án Mới

Bạn sẽ tạo một dự án mới có tên là CourseZone:

• Tạo thư mục mới có tên là CourseZone.
• Clone thư viện ezyplatform-development từ GitHub và chạy build.bat bên trong thư mục đó.
• Mở Command Prompt bên trong thư mục CourseZone và chạy lệnh sau để tạo dự án:

ezy.bat cp CourseZone -g com.learn -i admin-plugin,theme,web-plugin

9. Chạy Dự Án CourseZone Vừa Tạo

Mở IntelliJ và chọn dự án vừa tạo là CourseZone. Chọn mục File → Project Structure và chọn JDK 8. Sau đó, nhấn vào Maven → coursezone → Lifecycle → install. Trong hai thư mục coursezone-theme và coursezone-admin-plugin, đi đến:

• src → test → java → com và chạy lần lượt hai file:
  • CourseZoneAdminPluginStartupTest
  • CourseZoneThemeStartupTest

10. Đóng Gói và Xuất Lên EzyPlatform

Mở Command Prompt trong thư mục của dự án CourseZone và chạy lệnh:

export.bat

Rồi thực hiện clean và install để build lại dự án. Đến Run/Debug Configurations và chọn CourseZoneThemeStartupTest trong thư mục C:\github\coursezone\coursezone-theme.

11. Sử Dụng SCSS cho Dự Án

Clone mã nguồn từ GitHub: ezyplatform-examples và mở IntelliJ đến thư mục book-store-theme → src. Sao chép thư mục view vào dự án coursezone trong thư mục coursezone-theme → src. Tải Bootstrap 5.3.3 từ đây và giải nén. Truy cập vào thư mục coursezone → src → view → scss → vendor và sao chép thư mục scss từ giải nén vào đó với tên đổi thành “bootstrap 5.3.3”.

Mở Command Prompt trong thư mục dự án coursezone và chạy lệnh:

npm i

Sau khi cài đặt xong, tiếp tục chạy lệnh:

npm run sass

Kết Luận

Bạn đã hoàn thành việc xây dựng một dự án cơ bản trên nền tảng EzyPlatform thành công. Hy vọng rằng hướng dẫn này giúp bạn dễ dàng phát triển dự án của mình trong tương lai.
source: viblo