iOS项目的搭建到分发

本文主要介绍每当开启一个新项目的第一步:从项目的搭建到给团队分发模块开始开发的过程。现在虚拟一个即将要开始的项目叫:NewStart(新起点),通过这个项目你能看到整个项目的目录结构。假装要弄成下图的样子:

NewStart.gif

主要的框架设计如下:


image.png

建议先下载已经完成的代码代码代码,其实可以直接看代码的, 可以不用看这篇文章, 这里说的不全,其中也有很多的废话,我的表述也有些问题。毕竟一行代码胜过千言万语。下载代码下来之后, 在运行之前记得pod install一下。由于代码有更新,所以本文介绍主要是在git的第二个节点做介绍的:项目第一次提交,主要完成了项目的搭建到分发.

接下来、将会按照步骤依次做介绍。

一、git准备

刚开始工作那会一直使用svn来做代码管理,自17年初开始使用git、这次使用github来做介绍。一般情况公司都会有自己的git服务器。具体的步骤:

  • 1. 首先需要有一个项目组(group),一般是以公司为单位。比如XXXX公司的项目,都应该在一个组中。即使这个公司只有一个项目,也应该是单独的一个组。
  • 2. 在指定的项目组中创建一个项目,一个空的没有任何分支的git项目已经完成。
  • 3. 通过第2步创建的git项目,可以直接在网页把README.md文件也创建了。
  • 4. 将项目clone到本地,然后添加一个忽略文件(.gitignore)

以上是在工作中的git的常规步骤,现在使用github的流程走一遍, 流程是一致的, 唯一的区别是一个是group, 一个叫team, 其实都是一样的.

在自己的账号中创建一个team:

image.png

这是team创建成功的样子.

image.png

开始创建项目:


image.png

这是项目创建成功的样子:


image.png

现在为止, 一个git远程仓库就准备好了, 我们直接clone到本地,最终是这样子的:


image.png

到现在为止,一个git的全部准备工作就全部完成了。其实这个过程是很简单的,可以说不需要时间就能完成。[偷笑]

二、创建项目

在Xcode中创建完项目后是这样子的:


image.png

首当其冲的将项目的系统最低支持版本也改一下:


image.png

到现在为止, 一个简单的项目就算是结束了. 现在就可以提交远程给同事们开始开发了么?那肯定是不可以的, 还差得很远.现在只是有一个项目, 还需要将一个简单的框架搭建好才能给出去, 否则其它同事是会很乱的.至少还需要把一下3点完成:

  • 1. 项目的整体结构以及常用的基类
  • 2. 第三方
  • 3. 网络框架

这三点可以不是最终版本,但是一定要有,毕竟团队合作开发肯定得有一个方向,,否则不同的人肯定会弄出自己的一套,这样是不行的。下面根据以上3点分别做介绍。

1. 项目的整体结构以及常用的基类

目录小改动

添加 SupportingFiles 目录
在新版本的Xcode中没有SupportingFiles了, 但是习惯了这个文件,我们可以自己搞一个. 主要是习惯了将Assets.xcassets, Info.plist 与 main.m这三个文件放到这个目录下.

这里需要注意的是, 要在文件中将project.pbxproj文件中的INFOPLIST_FILE的值改一下, 因为改了Info.plist文件的路径。

添加 AppDelegate 目录
将AppDelegate的两个.h与.m文件单独放到这个文件夹中。

现在的样子是这样的:


image.png

在Xcode中, 目录合起来是这个样子的:


image.png

这样看起来还是比较简单明了清晰的,我感觉。其实到现在为止, 只是做了一个小小的调整而已, 还没有真正的搭建项目的结构。

添加 General 目录
这个目录是一个核心的目录,所有的代码都将会在这里。这个目录中也有这些的目录:Libs(用到的非pod管理的第三方库),Category(分类),Modules(项目的所有模块),Macro(基本的配置, 比如网络,基类)。如:

image.png

其实在上面的目录中的Libs与Category是可以许允为空文件的,具体可以在开发的过程中用到了再添加。但是Modules与Macro尽量一次性弄好。

Macro目录完善

在这个目录中,一般存放的是固定的, 以后即使要改的话,改动也不会太大的东西,或者即使要改也是全局性修改的那种。最终结果如下:


image.png

其实, 穿过图片就能知道这里面写的都是一些再基础不过的基本配置。换句话来说,几乎所有的项目都能通用, 即使改动也不会太大。

Modules目录完善

这个目录中, 就是项目的核心需求了。具体要怎么去搭建目录, 那就要看项目的实际结构了。
比如这样的:


image.png

主要是根据模块来区分, 然后在某个某个某块中以MVC的设计模式来做细化的区分。

2. 第三方

通常都会使用CocoaPods来管理第三方代码, 关于如何快速的添加, 可以看这个:给新项目添加Pod管理
是这样的:

image.png

或者是直接将别人的代码直接拖入项目中, 是这样的:


image.png

其中:
红框框中的是我自己写的, 感觉还算经典。
红框框中的是我自己写的, 感觉还算经典。
红框框中的是我自己写的, 感觉还算经典。
....

这部分,没有什么特别的, 想要什么就直接拖入什么即可。

3. 网络框架

网络框架,为什么一定要先体现弄好?
反正在我刚开始敲代码那会儿,我们的新项目是没有的, 然后团队中的每个人各领风骚, 本来一个项目的网络请求都应该是一个套路的, 否则最后会很乱。
同事们在使用的时候, 直接在这里来添加自己的接口即可:

image.png

通过自己的模块/功能自行创建分类,这样项目不会至于会乱。

到现在为止, 一个简单的项目搭建就算完成了,可以直接将自己本地的代码提交到远程, 告知团队开始进行开发了。记得创建一个develop分支。

直接在这里下载代码代码代码,下载代码下来之后, 在运行之前记得pod install一下。由于代码有更新,所以本文介绍主要是在git的第二个节点做介绍的:项目第一次提交,主要完成了项目的搭建到分发.

说在最后的话

这就是我这些年的一个项目简单搭建的一个过程,上面说了这么多,其实很多都是废话与多余的话,在实际情况中, 搭建一个项目的时间最多最多也就20分钟的事。

其实,到现在为止也深知这样搭建的项目是没有太大的技术含量的。首先比较突出的一点没有突出一个项目的组件化设计,这个是我接下来需要研究的方向。

对于我上面的代码,里面应该也能体现我的代码风格了, 比如登录界面是我之前学MVVM看雷神的MVVM With ReactiveCocoa学习的时候照葫芦画瓢弄的,我是将之前的代码直接拖过来的。

还有BaseControl与NetWorkEngine,也是我积累出来的:

image.png

推荐这篇文章Summary2017

要是有大神对我的简书与代码向我提出问题、建议与意见, 我将万分感谢!

谢谢!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容