codecamp

快应用 项目配置信息

熟悉描述整个项目的配置文件(<ProjectName>/src/manifest.json),掌握常用字段的意义:路由router、UI显示display

通过本节,你将学会:

配置应用基本信息

每个应用都要有专属的名称,图标等,这些信息都需要在manifest.json文件中配置;详细信息请参考文档:manifest文件

应用包名(package)

应用包名,是区别于其他应用的唯一标识

推荐采用com.company.module的格式,示例如下:

{
  "package": "com.example.demo"
}

应用名称(name)

应用名称,6个汉字以内,与应用商店保存的名称一致;框架提供保存到桌面的功能,桌面上显示的应用名即为此属性

示例如下:

{
  "name": "发票小助手"
}

应用图标(icon)

规则为正方形(不能是圆角),且务必无白边

{
  "icon": "/Common/logo.png"
}

注意:

请使用绝对路径,其中/对应于路径<ProjectName>/src/

应用版本名称、版本号(versionName、versionCode)

应用版本名称、版本号为开发者的应用包维护的版本信息

应用版本名称为主版本.次版本格式

应用版本号为整数,从1开始,每次更新上架请自增1

示例如下:

{
  "versionName": "1.0",
  "versionCode": 1
}

支持的最小平台版本号(minPlatformVersion)

支持的最小平台版本号为必填项,默认值为1000,标识开发者的rpk包兼容支持的最小运行平台版本

当使用了1000以上的平台版本新增特性时,就必须确保minPlatformVersion最低为该平台版本号,避免上线后在更低版本平台上运行出错

示例如下:

{
  "minPlatformVersion": "1000"
}

配置接口列表(features)

在使用接口时,需要先在manifest中声明接口。在每个接口文档的顶部,都附有声明接口的配置代码

以fetch网络请求为例,示例如下:

{
  "features": [
    { "name": "system.fetch" }
  ]
}

配置页面路由(router)

路由,用于定义页面的实际地址、跳转地址。如果ux页面没有配置路由,则不参与项目编译。一个目录下最多只能存在一个主页面文件(不包括组件文件)

首页名称(router.entry)

首页,即应用平台启动时默认打开的页面。首页需配置为应用中某页面的名称,即在<ProjectName>/src目录下,页面目录的相对路径

示例如下:

假设工程根目录如下所示

└── src
    └── Demo                  页面目录,存放各自页面私有的资源文件和组件文件
        └── index.ux          页面文件,文件名不必与父文件夹相同(推荐index.ux)

假设首页为Demo目录下的index.ux文件,则首页对应的页面名称为Demo

{
  "router": {
    "entry": "Demo"
  }
}

页面路由对象(router.pages)

页面路由对象,key为页面名称(<ProjectName>/src目录下,页面目录的相对路径),value为页面具体路由配置,key不要重复

页面具体路由配置(router.pages的value)包括以下属性:

  • component:页面对应的ux文件名
  • path:页面路径,不填则默认为页面名称(<ProjectName>/src目录下,页面目录的相对路径

示例如下:

假设工程根目录如下所示

└── src
    |── Demo                  页面目录,存放各自页面私有的资源文件和组件文件
    |   └── index.ux         页面文件,文件名不必与父文件夹相同(推荐index.ux)
    └── Doc
        └── Layout            页面目录,存放各自页面私有的资源文件和组件文件
            └── index.ux     页面文件,文件名不必与父文件夹相同(推荐index.ux)

当页面名称(router.pages的key)为Demo时,对应的页面配置(router.pages的value)包括:

  • component:页面对应的ux文件名index
  • path:页面路径,默认为页面名称Demo
{
  "router": {
    "pages": {
      "Demo": {
        "component": "index"
      },
      "Doc/Layout": {
        "component": "index"
      }
    }
  }
}

现在,开发者就可以通过/Demo访问到Demo目录下的index.ux页面了

配置页面UI显示(display)

UI显示,用于定义与UI显示相关的配置。支持定义:页面公用的默认UI显示、页面私有的UI显示

页面公用的默认UI显示

页面公用的默认UI显示,即被所有页面共享

以标题栏文字的配置为例:

{
  "display": {
    "titleBarText": "页面公用的默认标题"
  }
}

未配置私有标题的页面,标题栏文字均将显示为页面公用的默认标题

页面私有的UI显示

页面私有的UI显示,在display.pages对象下配置:key为页面名称(与路由中的页面名称保持一致),value为页面私有的UI显示

以标题栏文字的配置为例:

{
  "display": {
    "pages": {
      "Demo": {
        "titleBarText": "Demo页面的标题"
      }
    }
  }
}

总结

熟悉了常用配置项后,开发者就可以熟练的配置页面路由、UI显示等信息了


快应用 代码编辑配置
快应用 代码编辑预览
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

快应用 参考手册

快应用 安全

快应用 声音音频

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }