美文网首页项目
iOS项目的搭建到分发

iOS项目的搭建到分发

作者: CoderHG | 来源:发表于2017-12-28 01:15 被阅读539次

    本文主要介绍每当开启一个新项目的第一步:从项目的搭建到给团队分发模块开始开发的过程。现在虚拟一个即将要开始的项目叫: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

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

    谢谢!

    相关文章

      网友评论

      • 黄河石:楼主 写的不错 不过网络那里 token 生成是什么意思 为了防盗链?
        Auditore:@黄河石 https
        黄河石:@CoderHG 那登录接口刚开始返回的随机数会不会被盗取
        CoderHG:是的,防盗仅仅是一方面. 这个值一般是用户登录的时候通过登录接口返回的一个随机数. 登录成功之后, 每个接口都必传的字段,这个值无效或过期, 网络请求都不成功.
      • 可惜我是双鱼座:下载下来后 pod update 报错 [!] No `Podfile' found in the project directory.
        Auditore:cd到你xcodeproj文件所在的目录, pod init
        CoderHG:恐怕你没有cd到项目的文件夹中, 这个错误的意思就是当前directory没有Podfile文件.
      • 怀念裸奔的童年:pod install 出现 [!] Unable to find a specification for `HGCategorys`
        怀念裸奔的童年:好了需要执行pod update
      • YungFan:楼主问一个问题,按照你这样分好了以后,是不是每个开发人员只负责module下面的一个模块或者几个模块?如何进行分工?
        YungFan:@CoderHG 好的 谢谢回答 这样就不会相互干扰了 也不出现SB共享的问题了
        CoderHG:@YungFan 是的,主要是通过Modules目录下面进行分工的. 按照我的经验,一个项目总有那么一个核心模块很复杂,总有那么几个模块简单(设置,我的).关于如何进行分工,会因为项目需求不同而不同. 作为一个项目的负责人,还需要考虑不同模块之间的衔接与共用的的小模块.

      本文标题:iOS项目的搭建到分发

      本文链接:https://www.haomeiwen.com/subject/xznygxtx.html