# magic-app **Repository Path**: highlightBoy/magic-app ## Basic Information - **Project Name**: magic-app - **Description**: 优雅的编码,创建富有交互性,用户体验良好的H5 APP - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 31 - **Created**: 2015-10-26 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README #MagicAPP

MagicAPP,专为WebAPP而生的开发框架,致力于轻松的写代码,产出用户体验优秀的APP。生成代码可以直接用于移动端,微信端。结合打包工具,可以非常方便的转为原生APP,供用户下载使用。

框架自带一整套的UI,同时整体架构合理灵活,各部分可以单独拆出运行,亦可与其他的框架,库等配合使用。目前框架处于开发预览阶段,可能会有极大的改动,使用请注意。

##基本使用方法: ###1.安装依赖工具及初始化 ```JavaScript npm install npm install -g gulp cordova gulp build ``` ###2.监控运行 ```JavaScript gulp serve ``` ##Cordova 打包说明: ###1.创建 Cordova 文件夹

先在 项目根目录下 创建一个 cordova 的项目,命令说明如下:

```CLI cordova create [文件夹名] [软件ID] [Main方法名] ```

目前,为了脚本处理方便,文件夹名必须为 cordova,其它两个参数可自定义,比如:

```CLI cordova create cordova com.wbasic.weishop weishop ``` ###2.添加编译平台

项目创建完毕后,必须先添加编译平台,命令如下:

```CLI cordova platfrom add [平台名](android/ios) ```

比如添加 Android 平台可以执行如下命令:

```CLI cordova platform add android ``` ###3.执行打包操作

每次打包,都需要 先编译HTML文件,然后打包成APP安装文件,如果已经编译过了,可以直接打包成安装文件。

编译HTML文件需要在项目根目录执行以下命令:

```CLI gulp cordova ```

编译完成后cordova 根目录 执行 cordova build [平台] 命令来生成对应平台安装文件,也可以直接运行 cordova run [平台] 命令来生成打包文件并安装到设备上,比如对于 android 平台则可执行:

```CLI cordova build android ## 只生成安装文件 cordova run android ## 生成并安装文件 ``` ###4.配置文件修改说明

有时候需要修改配置文件,比如 安卓平台的 AndroidManifest.xml 文件,但是有时候修改后编译会失败,提示:You may not have the required environment or OS to build this project.

导致这个情况是由于有的插件会自动插入一些配置信息,如果你更改了最终的配置信息,两者不匹配 的话,就会出错。因此我们只要保证自动插入的信息和最终的配置信息一致就可以。

比如对于安卓平台,自动配置文件是 plugins/android.json 文件,所以我们只要保证 android.jsonAndroidManifest.xml 两个文件的配置信息一致,那么修改就不会出错。