Khala-Wan`

PodMan使用手册

• APP

《PodMan使用手册》是我的MacOS APP:PodMan 的使用介绍。如果在使用上有什么不明白的可以参考这篇文章。

登录

当你第一次打开APP会出现登录页面,你可以选择用GitHub账户进行登录,也可以跳过登录以后再说。值得一提,目前登录方式是OAuth授权,而需要github Token的功能还没有加入。可以跳过登录。

主页面

登录之后会进入PodMan的主控制页面如下:

主页面分为三个部分,从左向右分别是:主功能Tab选择窗口、项目列表、Pod操作面板和输出窗口。

PodFile相关使用

PodFile的操作相对简单和单一。

添加/删除 本地项目

项目列表窗口下面有两个按钮

分别是:添加本地项目和删除本地项目按钮。点击加号按钮便会弹出文件选择窗口,目前支持选择三种文件格式:

  • .podspec (代表这个项目是一个Pod项目)
  • .xcodeproj (代表这个项目是一个普通项目)
  • .xcworkspace (代表这个项目是一个普通项目)

因为我们想要进行PodFile的相关操作,则选择xcodeproj或xcworkspace。之后在项目列表中就可以看到我们刚刚添加的项目了。选中该项目之后在最右侧的操作面板中,Init、Install和Update按钮变为可用状态。点击它们分别对应pod initpod istallpod update 操作。点击后可以在上面的窗口中看到输出效果。

想要删除某个项目,选中该项目并点击减号按钮即可。

Pod相关使用

PodMan的主要功能是用来日常的管理和维护Pod项目,尤其是私有Pod,下面来看看如何使用。

设置私有specsRepo

如果你的项目是要发布到CocoaPods公开源的Pod那么你可以略过这个步骤

点击最左侧下面的设置按钮便会弹出如下页面:

当你第一进入这个页面你的私有Specs repo可能是空白的。点击新增按钮在弹出的窗口中输入NameHTTPS URLSSH URL三个选项。

Name : 这个Specs Repo对应的名称 (你想叫什么都行)

HTTPS URL : 这个Specs Repo对应的Https的URL

SSH URL : 这个Specs Repo对应的SSH的URL

注意:如果你的电脑配置了两个以上(包括两个)的Github SSH.那么填入 SSH URL中的URL必须是你映射之后的URL:比如我自己的就是 git@github_work:xxxxxxxxxx

设置完成之后返回主控制页面。

添加/删除 Pod项目

添加/删除的流程和添加普通项目一样。不过因为是Pod项目,所以你还需要完成进一步的设置。如下:

是否是私有Pod的选项如果勾选则必须指定你之前添加的私有specRepo的名字。如果不是私有Pod那么直接点击完成即可。

随后会在项目列表中看到刚才添加的Pod项目,在名字之后还有它当前的版本号(从podspec文件中读取)。选中某个Pod项目即可激活Pod相关操作的按钮。 目前支持:

  • 本地验证
  • 远程验证
  • tag
  • 发布

Pod可选参数设置

在操作按钮上方还有三个勾选框对应:

  • Allow Warnings : –allow-warnings
  • UseLibraries : –use-libraries
  • Verbose : –verbose

他们在Pod命令中的作用我就不多说了,通过勾选和取消它们,可以解放你的双手,不用每次操作都要带着这些参数输入命令行了,而且,你的这些设置PodMan都会帮你保存下来,方便你的下次使用。

Tag && Release

Tag和Relase按钮在右上方。Tag会根据你在podspec文件中所指定的版本号自动帮你完成 git的 tag / push tag 操作

Release功能会根据你的设置判断当前这个Pod项目是否是私有项目。如果是私有Pod。那么会自动push到你之前指定的私有Specs Repo里面。反之,会推送的CocoaPods官方的公有源repo中。

创建新的Pod项目

还记得之前创建Pod的过程吗。需要和Terminal进行交互式的输入。选择语言、测试框架等等。这PodMan之中,只需要勾选你想要的类型即可。 点击创建按钮,在面板中选择你想要的。如果是私有Pod则还需指定你私有的Specs Repo。

便捷使用方法

经常我们在维护一个Pod项目的时候,一般都是在Xcode窗口中操作。切来切去的很麻烦,我也这么觉得。所以我提供了更方便的方法来让大家使用,你只需要开着PodMan选中你要操作的项目,然后在Xcode界面中写你的代码就好。当你想要进行Pod相关操作的类型时,细心的同学肯定发现了在屏幕最顶上的StatusBar中有PodMan的一个按钮。点开会看到你当前Pod的名称,和相关操作按钮与其对应的快捷键。不要犹豫,点下去吧!

然后你可以什么都不用管,继续coding,等执行有了结果PodMan会告诉你的,你会看到如下推送:

写在最后

PodMan是我迈入MacOS开发的第一个APP。使用了Xcode9和Swift4.0,耗时大半个月。在体验和技术细节上还有不足之处。欢迎issue 、 PR等一切让PodMan变得更好的方式~。谢谢大家。