0.0.10-7 • Published 2 years ago

med-mars v0.0.10-7

Weekly downloads
-
License
-
Repository
-
Last release
2 years ago

med-mars

百度健康是集医疗服务和医疗内容于一体的一站式平台,手百端内为小程序(搜索-百度健康),端外为H5( https://expert.baidu.com

开发准备

权限申请

1、申请「百度健康」小程序成员权限:FE选择「开发者」权限即可
2、申请「百度健康」H5上线权限:联系@liuxianrui,添加AE-APP56上线权限

安装

1、git clone
2、cd med-mars
3、npm install

工具准备

1、小程序开发工具下载:https://smartprogram.baidu.com/docs/develop/tutorial/install

评审

参加需求评审后,需要PM在需求空间 对应类名下添加需求卡片

开发 + 联调

适用于:FE编写页面样式和业务逻辑、与RD进行前后端联调

「小程序开发环境」

1、修改请求接口域名(如联调时):

// src/utils/conf.js 中修改 apiHost 为要请求的后端接口域名,如:

const apiHost = 'http://bjyz-migrate-big-mem-zyl02.epc.baidu.com:8977';

2、npm run serve

3、在小程序开发工具中打开编译产物 dist-swan,查看效果

4、npm run dev [path,path] path为从pages开始到任意位置的一个目录级别路径(eg: pages/brand/home),该命令开发时仅编译指定目录下的文件。

「H5开发环境」

1、修改请求接口域名(如联调时):

// src/utils/conf.js 中修改 apiHost 为要请求的后端接口域名,如:

const apiHost = 'http://bjyz-migrate-big-mem-zyl02.epc.baidu.com:8977';

2、npm run serve:h5

3、关闭chrome浏览器安全策略进行预览(解决本地访问跨域问题):open -n /Applications/Google\ Chrome.app/ --args --disable-web-security --user-data-dir=/Users/用户名/MyChromeDevUserData

「mock」

若开发过程中需要mock数据,可使用平台:http://yapi.baidu-int.com

SEO接入

1、seo.config.js 中新增短路径配置(如当前路径满足需求可不写);

2、与后端协定TDK,通过 shareBDBox 方法修改页面TDK,简单实例如下: 2.1、升级改造了share.js支持传入多图(2021.10.15)

import {shareBdBox} from '@utils/share';

const seoData = res.data.seoData || {};

// 单图
const shareInfo = {
    title:  seoData.title,
    content: seoData.desc,
    keywords: seoData.keywords,
    imageUrl: ,// 需求页面的logo,头图等图片地址
    alt: ,// 需求页面的机构,套餐名称等
};

// 多图
const shareInfo = {
    title:  seoData.title,
    content: seoData.desc,
    keywords: seoData.keywords
    imageUrl: [
        {
            id:  ,// id,可不传,自动为 shareImg + 下标索引
            url: ,// 需求页面的logo,头图等图片地址
            alt: ,// 需求页面的机构,套餐名称等
        }
    ]
};

// process.env.BUILD_TARGET 为可获取seo环境变量,seo | web
if (process.env.MARS_ENV === 'h5' && process.env.BUILD_TARGET === 'seo') {
    shareBdBox(shareInfo);
}

3、同步代码:npm run sync:seo (注:同步机器需有线上nginx服务配置,如没有机器,可周知后同步至如下配置,访问:http://medfe04.bcc-szwg.baidu.com:8300/):

module.exports = {
    receiver: 'http://medfe04.bcc-szwg.baidu.com:8999/receiver', // 文件推送服务(公司内部统一使用)
    static: '/home/work/apps/med-mars', // H5静态文件部署目录
    template: '/home/work/apps/med-mars/template' // H5模板文件部署目录
};

走查

开发联调结束后,需要提供预览环境给UE、PM进行走查

「小程序走查环境」

开发工具中点击「预览」,生成预览二维码

「H5走查环境」

一般需要FE将前端编译产物推送到RD提供的开发机后,给出页面访问地址

1、修改H5产物部署路径

// med-mars/med-conf.js 中修改部署路径(不同开发机以下三项配置可能不同,具体找机器对应RD确认)

module.exports = {
    receiver: 'http://bjyz-migrate-big-mem-zyl02.epc.baidu.com:8999/receiver', // 文件推送服务(公司内部统一使用)
    static: '/home/work/search/paex.zjh/0.ae-app-56-fenji.test/data/webroot/med-h5', // H5静态文件部署目录
    template: '/home/work/search/paex.zjh/0.ae-app-56-fenji.test/data/template/med-h5' // H5模板文件部署目录
};

2、npm run sync

3、访问对应页面地址

提测

1、测试需求收集(每周一):加群23825147

2、修改需求空间中对应卡片状态未「已提测」,QA根据卡片状态排期测试

3、开始测试时通知负责QA,提供测试环境

上线

1、代码合入master:
1)提交代码,生成icode cr链接
2)cr FE同学 + 1
3)测试QA + 2
4) 合入

2、agile发布:http://agile.baidu.com/#/builds/baidu/ps-aladdin/med-mars@MasterPipeline@branches
1)找到自己提交的流水线,点击「发布」
2)待流水线流程走完,分别上线小程序和H5代码

3、小程序发布:
1)访问小程序开发后台:https://smartprogram.baidu.com/developer/home/package.html?appId=11806953
2)验证开发版本二维码,确认效果正确后,点击「提交审核」
3)审核通过后,点击「发布」,5分钟后冷启动小程序,验证线上效果

4、H5上线:
1)访问AE平台app56:http://appengine.baidu.com/aep/app/flowList?app_id=56
2)点击「新建上线版本」
3)新页面 - 「选择上线单元和模块」勾选「908_问诊前端模板」中产物版本,填写「版本描述」,点击「确认」
4)1分钟后刷新页面(跳过代码测试),点击「部署」,生成对应tower上线单
5)上线进度到stage0时,为单机,此时进行单机验证,地址为:http://bjyz-ps-ae-fenji-api1.bjyz.baidu.com:8656/med/template/#/pages/brand/home/index?lid=4914395780
6)验证通过后继续部署后续阶段,至上线结束,验证线上效果

相关文档

小程序官方文档

mars官方文档

mars-ui官方文档