Liferay官网:https://www.liferay.com
Liferay开发:https://dev.liferay.com/
注:平台为Mac,Windows的操作忽略,请参见其他教程
1. 环境搭建
(1) Eclipse
官网下载 Eclipse完整包,开始尝试过下载Eclipse Installer,但安装失败。
(2) java jdk
使用的jdk1.8,ORACLE官网下载,选择Mac OS X,下载并安装。在Terminal中查看java -version
,由于之前使用的是1.7,此处需要修改java home 路径:
[1] vim ~/.bash_profile
[2] 点击i,修改到正确路径
[3] 按ESC,然后按 :wq
[4] source ~/.bash_profile
让配置文件在修改后立即生效(若无效可重启电脑)
(3) Liferay插件
下载Liferay的Eclipse插件,完成后不需要解压。进入Eclipse,Help -> Install New Software -> Work with 后面的Add按钮 -> Location 后的Archive按钮 ->选择下载的包
2. 创建Liferay工程
(1)创建Liferay Workspace
在Eclipse中选择 File -> New -> Other ->输入 Liferay WorkspaceProject ,弹出框选Yes。
(2) 新建bundle
在Terminal中通过cd ..
以及cd 文件夹名称
进入workspace的根目录。./gradlew initBundle
自动下载bundle。
此时,运行Eclipse中的Server,Liferay可以跑起来了。
3. 安装Liferay Theme
参考官方教程Themes Generator一章,
(1) 安装Node.Js
可通过命令node -v查看
,出现版本信息表示已安装
(2) 安装npm环境
电脑上已有略过,详细方法参见官方教程
(3) 安装全局Yeoman 和 gulp
官方提供方法npm install -g yo gulp
,显示错误信息Please try running this command again as root/Administrator. 所以,需要在命令前加sudo
,用管理员模式,需输入密码。sudo npm install -g yo gulp
(4) 安装Themes Generator
输入命令 sodu npm install -g generator-liferay-theme
(5) 安装Themes Generator
4. 运行Liferay Theme
运行yo liferay-theme
(1) 输入theme名称
(2) 输入theme ID
使用默认ID,可直接回车
(3) 输入Liferay 版本
(4) 输入Server地址
(5) 输入URL,默认为localhost:8080
此处注意,可能出现 Local host name unkown error,需设置HostName,如图。
(6) 输入gulp deploy
将路径切换到新建的theme下,输入后会同步到liferay中的可选主题中。
5. 自定义Liferay Theme
注:所有的修改,需在src中进行,需与build中镜像,即相同名称override
(1) css修改
找到src -> css -> _custom.css文件,需要自定义的css样式写入该文件中即可
(2) freemarker文件修改
将build文件夹中的templates文件夹拷贝到src下,修改对应文件即可
(3)编译代码并运行工程
输入gulp deploy
可编译,在运行eclipse中的工程就能看到自定义修改后的变化
6. 部署及如何删除Liferay Theme
liferay工程的根目录 -> bundles -> osgi -> war
此处可以看到以主题名称命名的war包。实际上,主题在编译的时候是打成这样的war包在java中使用的。所以,在部署时,只需拷入war包即可。同样,为删除主题,可以直接将对应war包删除。
注意:在运行eclipse过程中,可能会出现端口被占用的情况。
(1) 输入ps -e | grep java
查找出tomcat进程id
66192 ?? 5:13.86 /Library/Java/Java…
(2) 输入kill -9 66192
杀掉进程