目的
编写这篇文档的目的是为了帮助新同事尽快了解工作内容、熟悉工作环境,以及对协同合作的方式有一定的了解,并对合作方案有初步的讨论。
一、工作内容
暂定
所有wifi密码:十个小写字母a
二、工作要求
- 对工作任务有较明确的计划,对任务进度能有掌控
- 有良好的开发习惯,详见《Android开发规范》
- 多交流沟通,善于思考提问,不要盲目开发
三、协作成员介绍
安卓组:
- 钟杰:android 开发人员
后台成员
- 匡佐强:技术总监,后台技术组组长。公司最熟悉RP的人之一
- 黄剑虹:接口总负责人。
- 李璐:接口开发人员
前端成员
- 万宜城:前端负责人
- 奚思源:负责weex界面开发
- 郭琦:前端开发人员
测试成员
- 刘艳红:测试人员
RP
- 李红玲:RP产品助理,公司最熟悉RP的人之一
设计
- 聂仁姣:UI设计师
其他
- 叶涛:猫窝长沙负责人,工作是的问题可以找他聊。
- 彭双双:前台,HR,有什么小问题可以找她。关于公司的制度,生活上的问题。
四、资源
公司Q群 & 公司邮箱: 请找彭双双获取。
1. 项目svn地址:
-
账户密码:找匡佐强申请
-
Android项目地址:svn://47.97.105.116/lianke/lianke/trunk/code/smartmall/
-
Android相关文档:svn://47.97.105.116/lianke/lianke/trunk/doc/Android开发相关文档
- Android开发规范[待更新]
- common包介绍[待更新]
- 第三方库介绍[待更新]
-
设计相关地址:svn://121.199.12.183/lianke/lianke/trunk/doc/1需求/
- UI原型界面/20160526/5月app新UI
- RP/猫窝C端原型
这是持续更新的C段的原型。即由李红岭负责的PR原型,有什么问题可以咨询他。请找她获取最新的RP地址。
2. 项目源码地址:
项目源码后台:https://git.mao-wo.com/ (账号找匡佐强申请)
C端项目源码地址:https://zhongj@git.mao-wo.com/maowo-saas/android/ModularizationC.git
B端项目源码地址:https://zhongj@git.mao-wo.com/maowo-saas/android/ModularizationB.git
3. 开发环境
- Android studio 3.0.1 + Grdle 4.1
- SVN
- Git
4. 接口文档 :
[Maowo科技API] : https://redmine.mao-wo.com/
账号密码:找匡佐强申请
[C端API]: https://redmine.mao-wo.com/projects/qu_guang_guang_app_api/wiki
[B端API]: https://redmine.mao-wo.com/projects/qu_guang_guang_store/wiki
五、项目介绍
项目基于组件化开发(非插件化),开发框架已经搭建完毕,已有需求全部开发完成,目前出于等待新需求的阶段。但是我们的项目和市面上的组件化又有一些区别,区别在于没有为每个单独的组件模块设置编译环境(仅此一点),我们暂且称之猫窝组件化方案。
关于工程源码的介绍,请看源码项目地址上的readme.md文档,可以有个初步的了解。
六、组件化相关介绍:
- 什么是组件化开发:https://blog.csdn.net/dd864140130/article/details/53645290
- 组件化开发的实践思路参考:https://kymjs.com/code/2016/10/18/01/
- 猫窝组件化相关文档:
- [组件化开发之模块拆解方案简述] https://www.jianshu.com/p/beb327d16291
- [猫窝Router方案说明]https://www.jianshu.com/p/16a402311eee
七、 开发规范
详见文档:《猫窝科技Android开发规范》[待更新,可以先看看,改动不会特别大]
八、特殊文件说明 (供参考,有变更)
- 对于Bundle传参KEY,统一定义在configure模块中constant包下的BundleKeys.java文件中
- 一般常量统一定义在configure模块中constant报下的ConstantValue.java文件
- 对于后期需要持有的第三方密钥,统一定义在configure模块中moconfig包下SmartmallConfig.java文件中
- 接口地址,统一定义在configure模块中moconfig包下URLConfig.java文件中
- 定义的全局BaseSmartCallback,已经处理部分数据逻辑,因为后台的数据有一套固定的格式
- 封装好了的BaseActivity,BaseRequestUrlActivity(FragmentActivity、Fragment、ViewPage),请继承这套模板。
- DialogUtil可以动态加载空界面,loading界面,progress界面
- PreferencesManager为sharedPreferences帮助类
- 所有的颜色值都定义在configure包下,定义格式如下:
<color name="cBBBBBB">#bbbbbb</color>
命名:c+XXXXXX(大写颜色值)
值:具体颜色值,大小写无所谓。
注意:由于操作同一个资源文件极易造成冲突,建议没人创建一个不同名的xxxx_color.xml文件,避免冲突
- 因为UI设计师在切图时,没有考虑到android中的资源文件不能含有“-”,只能使用“_”做分割,所以我批量修改了所有UI切图,并且将所有切图资源全部放置在configure的drawable文件夹下。由于考虑到切图命名规范问题,为了避免冲突,我将所有切图资源进行了整理,分别为所有切图加上所属的模块命名。
对应关系
-
tab --> tab_xxx
-
登陆注册 --> login_xxx
-
活动 --> campaign_xxx
-
商圈 --> trade_xxx
-
我的 --> user_xxx
-
无数据 --> null_xxx
-
消息 --> message_xxx
-
约吧 --> date_xxxx
-
字体统一定义在configure模块资源文件下,格式为<dimen name="spxx">xxsp</dimen>
例如:<dimen name="sp14">14sp</dimen>
网友评论