工程使用文档

工程使用文档

工程目录结构

项目根目录
    ├── PowerMobile               // 项目文件夹
    │   ├── Resource              // ├── 基座及配置文件目录
    │   ├── Supporting Files      // ├── 项目支持文件目录（包含Info.plist 预编译文件 图片存放Assets.xcassets）
    │   └── AppDelegate           // ├── 项目启动入口AppDelegate
    ├── Podfile                   // Pod配置文件
    ├── Frameworks                // 核心库目录
    │   ├── PMUISDK               // ├── PMUI核心库
    │   ├── WeexPluginLoader      // ├── 外部组件注册库
    │   └── WeexSDK               // └── Weex核心库
    ├── PowerMobile.xcodeproj     // 项目工程文件
    └── PowerMobile.xcworkspace   // 项目工作空间文件（启动入口）

工程配置

  • 配置Frameworks文件夹下的核心库

    1.复制PMUISDK.framework到 Frameworks–PMUISDK 文件夹下

    2.复制WeexSDK.framework到 Frameworks–WeexSDK 文件夹下

    3.根据个人需要调整WeexPluginLoader文件夹下需要使用的WeexPluginLoader.framework，默认是模拟器版本。如需使用真机版本，请将WeexPluginLoader(arm64).framework重命名为WeexPluginLoader.framework

    注：建议使用不同名字保存两个版本，以备后用

  • 配置最新版本基座

    • 基座文件存放目录在 Resource–bundlejs–pmui 文件夹下，如需更新基座，将基座包中的文件夹替换pmui下的同名文件即可。

  • 项目配置文件

    • 配置文件存放目录在 Resource–bundlejs–pmui–config.json，配置文件包含 服务端URL 接口名字 第三方key等，基本参数说明如下：
      属性 类型 必须 描述 默认值
      serviceUrl String 是 服务端URL -
      homePage String 否 可指定首页路径 -
      homePageParams Dictionary 否 首页页面参数配置 -
      appKey String 否 项目唯一标识 -
      pid String 是 基座唯一标识 -
      stratAPI String 是 项目启动接口，包含：启动图 基座信息等 -
      staticPackageDetail String - H5离线包获取接口 -

环境配置

版本要求

  • ruby: 2.5.0 以上
  • cocoapods: 1.5.3 以上

其他版本会有环境问题

安装

  • CocoaPods(建议使用pod 1.5.3或之后版本) —CocoaPods环境没有问题，可跳过此项

    • 升级 rubygem 环境：$ sudo gem update --system
    • 移除现有 rubygem 镜像：$ gem sources --remove https://rubygems.org/
    • 添加gem.ruby-china镜像：$ gem source -a https://gems.ruby-china.com/
    • 安装 CocoaPods：$ sudo gem install cocoapods
    • 如果以上命令报错则执行：$ sudo gem install -n /usr/local/bin cocoapods
    • 最后执行：$ pod setup 过程比较漫长，请耐心等待执行完成

  • 进入到项目根目录，执行 pod install

cd /项目根目录

pod install

至此项目基础库配置完成

安装插件

插件可根据自己的需求安装，插件库地址 http://118.144.87.52:9988/PMUIDelivery

  • 拉取插件源码到本地
  • 配置 Podfile 文件
target 'PowerMobile' do
    common
    #----------自定义插件引用-----------
    #文档Demo插件
    pod 'TestPlugin', :path => '../../PMUI-Plugins/TestPlugin'

end

配置插件名，插件路径，以TestPlugin.podspec为例，TestPlugin为插件名，path 后面的是下载的插件文件路径

../ 表示以Podfile为当前路径返回一层，../../ 则表示返回两层，最终是要找到podspec文件所在的路径

  • 执行安装命令
pod install