# mobileplus

**Repository Path**: sz_resources/mobileplus

## Basic Information

- **Project Name**: mobileplus
- **Description**: mobileplus工程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: cluster
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2017-05-02
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# How To Run

* 安装mongodb
* 安装node.js
* 安装coffeescript
* 安装imagemagick和graphicsmagick（图片处理）
* 克隆代码
* 安装依赖
* 运行

## 安装mongodb

### OSX
Mac开发环境推荐通过homebrew安装到本机。

默认配置如下：

配置项 | 默认值
------|-------
地址 | mongodb://127.0.0.1/appbricks
user | null
pass | null

若配置了用户名密码，请自行修改db/mongodb.coffee文件。

### Linux
请参考[Mongodb官方文档](http://docs.mongodb.org/master/administration/install-on-linux/)

### 其他
若使用远程服务器，或使用docker方式访问，请修改db/mongodb.coffee文件修改相关配置。

## 安装node.js
通过homebrew安装或自行编译安装，参考官网安装指南 http://nodejs.org/

## 安装coffeescript
app-builder的服务器端使用coffeescript编写，因此需要安装coffeescript进行开发及运行
```
sudo npm install -g coffee-script
```

## 安装imagemagick和graphicsmagick其中一个

安装homebrew
```
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
通过brew安装imagemagick和graphicsmagick
```
brew install imagemagick --with-webp
brew install graphicsmagick
```

## 克隆代码
```
git clone https://git.oschina.net/yezhiming/app-builder.git
```

## 安装依赖
针对前端开发，有大量gulp的依赖，实践中安装这些依赖需要较长实践。
gulp依赖都配置在devDependencies（开发依赖）中。
如果只需要运行或部署，则添加--production参数，可以大大加快依赖安装速度。
```
cd to-your-project
npm install --production
```

安装mongoose中间件经常会报错，原因多数是bson库编译失败，尝试以下方法解决：
```
[sudo] npm install mongooseinstaller
mi
```

## 运行
```
coffee server.coffee
```
app-builder默认使用3000端口，运行成功后，通过浏览器访问http://localhost:3000

## 生产
```
gulp dist // 打包appbricks平台本身
gulp build:project -p {path} // 打包外部项目，该项目只有项目代码，没有runtime逻辑；例如demos里面的项目
gulp build:project:standalone -p {path} // 打包外部独立项目，该项目有runtime可以独立运行，例如微银行、sum
gulp build:project:extension -p {path} // 只压缩该项目的extension-library.js
  eg：gulp build:project:extension -p ~/.appbricks/sandbox/55bf2054d4a348a329f7a28c
```

## node 调试
```
安装调试插件
npm install node-inspector -g

启动项目
coffee --nodejs --debug server.coffee

启动调试工具
node-inspector

在浏览器输入调试
http://127.0.0.1:8080/?port=5858
```


## 初始账户
系统使用的是邀请码注册，所以第一个用户也需要邀请码才可以注册，在开发环境下，访问`http://localhost:3000/generateInviteCode`,
查看控制台显示的邀请码，然后走正常注册流程

## 初始化数据
```
cd util_scripts
coffee uppagetpls.coffee # 加入模版数据
```
*TODO* - 需要补充一个方便的初始化脚本一次性初始化开发环境

# 开发指南
* [技术堆栈](docs/technical-stack.md)
* [核心框架](docs/core.md)
* [开发指南](docs/development-guide.md)
* [扩展点](docs/extension-points.md)
* [样式，主题，皮肤](docs/styling-guide.md)

* [数据中心-元数据API](docs/datacenter-metadata-api.md)
* [数据中心-数据API](docs/datacenter-data-api.md)