face: A JavaScript repository from eightfeet

activity-framework

升级到 preact10.X

因为preact-cli创建的preact项目无法像Create-react-app创建的项目一样通过npm run eject来高度自定义配置，因此升级activity-framework项目的preact到10.x以更灵活定制项目和支持preact新的功能特性

其他变更

remove preact-compat，preact已将preact-compat移植到内核中，无需单独引用
升级preact-router到3.x
移除preact-redux，用react-redux替代，preact-redux尚未更新目前还不支持preact10.x
8.x版本已移至preact-8.x分支

用于快速创建活动的preact框架，不包含测试模块。

快速概述

git clone ...
npm i 
npm run dev

然后打开http://localhost:8090/查看您的项目。准备部署到生产环境时，使用npm run build打包生产。

demo

当然这步交由运维打包发布更好，详见运维发布项目

项目结构

├─ README.md
├─ node_modules 
├─ deployPro.sh #生产环境发布exeample
├─ deployUat.sh #Uat环境发布exeample
├─ package.json
├─ postcss.config.js
├─ src #开发目录
│  ├─ actions.js #redux actions
│  ├─ assets #公共资源目录，内容直接copy不被打包
│  ├─ components #公共组件目录
│  │  ├─ app.js # 路由调度
│  ├─ config.js #定义环境变量下的配置文件
│  ├─ core #核心文件，polyfill、history配置等信息
│  ├─ favicon.ico
│  ├─ index.ejs #ejs 模板文件
│  ├─ index.js #入口文件
│  ├─ reducers.js #redux reduce
│  ├─ routes #路由page页面组件
│  ├─ style #公共样式目录
├─ webpack.config.js
└─ yarn.lock

webpack打包环境变量

__UAT__: 测试环境,

__PRO__: 生产环境

__PUBLICKPATH__:公共path，默认为当前相对路径 ./，

当cdn打包时__PUBLICKPATH__则为cdn路径 http://cdn-yyj.4000916916.com/yourpath

使用方式参考 ./src/config.js

script

npm run dev

开发 hot mode

npm run build:uat

uat 打包

npm run build

prd 打包

npm run report

prd 打包并查看资源大小，以便合理分割代码

样式处理

框架支持sass打包，需要支持less等自行处理loader

1、公共样式与私有样式分开处理

`./src/style` 下存放公共样式，公共样式不进行模块化处理，可在各组件内部直接引用

其他组件的私有样式将进行模块化处理

2、sass变量统一引用

src/style/variables.scss 存放全局scss变量，这份变量将被其他scss文件自动引入，而无需在各个文件单独@import

代码分割

结合webpack4 的Dynamic Imports 与 react-loadable 结合以组件为单位分割优化你的代码。

import Loadable from "react-loadable";

// Code-splitting
const View = Loadable({
	loader: () => import(/* webpackChunkName: "Home" */ '~/routes/view'),
	loading(){
		return <div>Loading...</div>;
	}
});

运维发布

将打包发布统一交由运维完成，由shell脚本处理项目的拉取、安装、cdn配置、打包编译等工作，减少中间人为操作引起的失误。

cdn发布时 shell脚本定义cdn变量的名称务必为 PUBLIC_PATH，webpack打包时自动读取变量

#!/bin/bash
export PUBLIC_PATH=http://cdn-yyj.4000916916.com/yourpath
git clone ...
yarn
yarn build
#scp -r ./build/* ...

eightfeet/face