Hướng dẫn phát triển phần mềm

Dưới đây là quy tắc cho việc tham gia phát triển vào cộng đồng OpenCPS ###1. Môi trường và công cụ phát triển OpenCPS là một dự án được phát triển trên nền mã nguồn mở Liferay Portal. Các công cụ cần thiết cho việc phát triển bao gồm:

• Liferay Plugin SDK - Là bộ Plugin cho phát triển Liferay. Tải về | Link 2
• Bản Bundle with Tomcat - Là server chạy Liferay Portal tích hợp trong webserver Tomcat. [Tải về] (https://sourceforge.net/projects/lportal/files/Liferay%20Portal/6.2.5%20GA6/liferay-portal-tomcat-6.2-ce-ga6-20160112152609836.zip/download) | [Link 2] (http://4share.vn/f/221615151b171715/liferay-portal-tomcat-6.2-ce-ga6-20160112152609836.zip)
• IDE Eclipse with Liferay SDK Plugin - Phiên bản eclipse tích hợp plugin SDK của Liferay. [Tải về - Linux 32 bit] (https://sourceforge.net/projects/lportal/files/Liferay%20IDE/2.2.4%20GA5/liferay-ide-eclipse-linux-x32-2.2.4-ga5-201507230603.tar.gz/download) | [Tải về - Linux 64 bit] (https://sourceforge.net/projects/lportal/files/Liferay%20IDE/2.2.4%20GA5/liferay-ide-eclipse-linux-x64-2.2.4-ga5-201507230603.tar.gz/download) | [Tải về - Window 32 bit] (https://sourceforge.net/projects/lportal/files/Liferay%20IDE/2.2.4%20GA5/liferay-ide-eclipse-windows-x32-2.2.4-ga5-201507230603.zip/download) | [Tải về - Window 64 bit] (https://sourceforge.net/projects/lportal/files/Liferay%20IDE/2.2.4%20GA5/liferay-ide-eclipse-windows-x64-2.2.4-ga5-201507230603.zip/download) | [Tải về - MacOX 64 bit] (https://sourceforge.net/projects/lportal/files/Liferay%20IDE/2.2.4%20GA5/liferay-ide-eclipse-macosx-x64-2.2.4-ga5-201507230603.tar.gz/download) | [Link 2] (http://4share.vn/f/457172727c707076/liferay-ide-eclipse-linux-x64-2.2.4-ga5-201507230603.tar.gz )
• JDK 7u79 - Môi trường Java cho phát triển dự án. [Tải về - Chọn phiên bản theo máy phát triển] |(http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) | [Link 2] (http://4share.vn/f/5165666668646463/jdk-7u79-linux-x64.rpm )
• MySQL - Hệ quản trị cơ sở dữ liệu cho dự án. [Tải về - Chọn phiên bản theo máy phát triển] (http://dev.mysql.com/downloads/mysql/) | [Link 2] (http://4share.vn/f/4c787b7b75797974/mysql-workbench-community-6.3.6-1.fc23.x86_64.rpm)
• Library : [Library link]
• File cấu hình (build-common-plugin.xml) : build-common-plugin.xml

###2. Các bước cấu hình môi trường phát triển

2.1. Mô hình lưu trữ tổ chức code của dự án

Code của dự án được lưu trữ tập trung tại kho Github VietOpenCPS, quy trình thực hiện việc tham gia phát triển dự án theo thứ tự được mô tả như sau:

(1) Thành viên (nhóm) tham gia phát triển sẽ fork source code của dự án qua kho code cá nhân (nhóm).

(2) Sau khi fork qua kho cá nhân, thành viên thực hiện clone về kho local. Tại kho local nơi chứa code của dự án các thành viên cập nhật các tệp mã của mình và tiến hành commit lên kho local.

(3) Tại kho local các thành viên phát triển thực hiện việc push lên kho cá nhân trên GitHub.

(4) Trên kho cá nhân sau khi hoàn thiện các chức năng và muốn đóng góp vào cho dự án sẽ thực hiện việc pull request đến kho trung tâm. Tại đây code sẽ được kiểm duyệt trước khi đưa vào kho code chung của cộng đồng.

2.2. Cấu hình môi trường phát triển trên kho local của thành viên

Như trên ta có thể thấy sau kho clone source code về máy cá nhân phát triển ta sẽ cần phải cấu hình cho việc phát triển sản phẩm.

Đứng tại thư mục [path-to-workspace]\workspace\ ta thực hiện việc clone mã nguồn từ kho cá nhân về kho local với lệnh git clone. Sau khi thực hiện lệnh ta đã đồng bộ về được mã nguồn từ kho cá nhân về kho local và được lưu trữ tại thư mục có đường dẫn [path-to-workspace]\workspace\opencps.

Các bước thực hiện cấu hình phát triển với Eclipse:

• Trên Eclipse ta trỏ workspace vào thư mục [path-to-workspace]\workspace\.

• Giải nén tệp Liferay Plugin SDK đã tải về và copy toàn bộ nội dung thư mục và tệp bên trong (ngoại trừ 3 thư mục portlet, ext, hook) vào thư mục [path-to-workspace]\workspace\opencps.

• Tìm vào 3 thư mục hook, portlet, ext của Liferay Plugin SDK coppy toàn bộ các file vào 3 thư mục tương ứng của [path-to-workspace]\workspace\opencps.

• Thay thế build-common-plugin.xml vào [path-to-workspace]\workspace\opencps.

• Giải nén Library.zip vào thư mục [path-to-workspace]\workspace\opencps\portlet\opencps-portlet\docroot\WEB-INF\lib. Thay thế tất cả các file nếu bị hỏi.

• Trên Eclipse chọn Window > Preferences > Liferay sẽ xuất hiện hộp thoại như hình dưới

![Cấu hình Liferay SDK Plugin] (https://farm2.staticflickr.com/1453/24921531983_12af89f54e_b.jpg).

Chọn Configure installed Liferay SDK Plugin > Add xuất hiện hộp thoại như hình, sau đó chọn Location trỏ tới thư mục [path-to-workspace]\workspace\opencps.

.

• Chọn cấu hình Runtime Enviroment, trên Eclipse chọn Window > Preferences > Liferay > Create a new Liferay runtime environment hộp thoại xuất hiện chọn Liferay v6.2 CE (Tomcat 7) nhấn next chọn đường dẫn đến server Tomcat đã được tải về và giải nén. Thông thường đưọc đặt tại thư mục [path-to-workspace]\workspace\

• Thực hiện import opencps-hook và opencps-portlet

• Thực hiện build tất cả các file service.xml

• Mở Ant build và thực hiện build hook. Sau đó build taglib ở opencps-portlet theo thứ tự build compile -> build-taglib. Cụ thể như hình duới:

• Cuối cùng và thực hiện deploy lên máy chủ (server).
• Lưu ý: Sau khi build các file service.xml nếu gặp lỗi như hình Ta phải thực hiện đổi đường links của ivy.jar.url nằm trong [path-to-workspace]\workspace\opencps\build.properties

với giá trị như sau :

https://repository.liferay.com/nexus/content/repositories/liferay-public-snapshots/com/liferay/org.apache.ivy/${ivy.version}/org.apache.ivy-${ivy.version}.jar

và đổi ivy version với giá trị:

_ivy.version=2.4.0_

###3. Cách deploy sản phẩm