创建您自己的 cocoa 个广告连播

Create your own cocoa pod

我检查了几个参考链接和关于如何创建 cocoa pods 的问题,尝试过:

其中

None 提供了完整的信息,我可以从中获得创建自己的 cocoapod 的所有步骤。


为什么?
主要是因为您想这样做,但是当您知道您将在大部分项目中一次又一次地使用该组件时,它已被证明是一种高效的方法。例如,提供占位符和字符限制 ¹UITextview,或者可以平移到所需方向和区域的视图。稍后我们将在完成 post.

的过程中创建

你需要什么?

  • Xcode,我们将在 Swift 5
  • 中开发此 pod
  • 你的系统配置了Cocoapod,here你可以找到怎么做
  • 一个想法,您认为符合 Pod 标准的东西,但还没有 在那里您可以发送拉取请求并进行更新以添加您需要的功能,这样对其他用户也有帮助。
  • 还有一点点意志,不要放弃,因为在这个 post 结束时,您的广告连播已发布到 cocoapods.org.

我们将如何进行?
你会看到的。让我们开始吧!


第 1 步:创建 pod 项目并编写代码。

  • 首先,在 mac 中创建一个文件夹,然后在终端中移动到该文件夹

    Tip: You can do that by typing cd folder/path of dragging your folder on the terminal after cd. Name it the same as your pod for future references. I will name it RPTInteractiveView. make sure to choose a unique name (it's a requirement) for your pod as well.

  • 记住 pod lib 这与 lintcreate 相关的内容是一件好事,它可以让您的生活更轻松。
  • 使用 pod lib create 创建 pod 项目。您可以检查该 here 的控制台日志。

    pod lib create RPTInteractiveView

  • 现在按照这些自动步骤进行操作,我已经添加了我的首选项,您可以按照自己的喜好进行操作:

    What platform do you want to use?? [ iOS / macOS ]
    >iOS
    What language do you want to use?? [ Swift / ObjC ]
    >Swift
    Would you like to include a demo application with your library? [ Yes / No ]
    >Yes
    Which testing frameworks will you use? [ Quick / None ]
    >None
    Would you like to do view based testing? [ Yes / No ]
    >No

  • 完成这些步骤并完成处理后,将创建项目,如果一切顺利,您的项目将在 Xcode 上自动启动,检查类似的结构:

  • 现在您可以编写代码来帮助其他开发人员。我更喜欢在我的示例鳕鱼中这样写,为什么?因为如果您在 pod 项目上编写代码,那么每次 您尝试查看编写的代码的反映时 您将不得不清理并重新 运行 代码。

    • 继续编写调试和测试,直到您对结果满意为止。一旦你觉得你准备好了,你可以将你的代码移动到 pod 文件。
    • 你可以看到上图中,在Pods->Development Pods->RPTInteractiveView.swift里面你还可以注意到旁边有一个R,那是因为我重命名了它(这里的名字没有'没什么大不了的)早些时候它曾经是ReplaceMe.swift,我完全按照它的要求做了。
    • 现在将您的代码移至此处(如果它在示例文件夹中,则将其从文件中删除)清理项目。将您的 pod 导入到 class 您用来测试它的地方,再次 运行 您的项目,您应该能够看到您创建的所有内容,就像您创建它的方式一样。
    • 是不是很开心?也可以在另一个控制器中使用它。在测试中疯狂。 :-)
    • 好的,您可以在您的任何项目中将其用作开发 pod,只需将其添加到您的 pod 文件中即可

      pod 'RPTInteractiveView', : path => '/path/to/my/pod/RPTInteractiveView'

    • 虽然它将是一个本地 pod,但只有 mac创建此 pod 的 hine 中的项目才能访问它。

步骤 2:创建远程存储库

  • 现在,如果您想共享此 pod 并正确维护版本控制,则需要将其推送到 git。
  • 在 git 平台上创建一个 repo,将其命名为与你的 pod 相同的名称(你知道我的是 RPTInteractiveView)。它不一定必须在 GitHub 上,但我正在使用它。由于我们将在全球范围内提供我们的 pod,请保留 repo public.

第 3 步:元数据

  • 现在您已经投入了时间和精力并且喜欢您的 pod,您更有动力进行下一步,我们程序员通常不太喜欢,更新元数据。您必须处理 Podspec Metadata 文件夹中的所有文件,如上图,您可以看到它是从顶部开始的第一组,就在项目名称下方。

    1. .podspec:这将是唯一将托管在 Podspecs² 上的文件,因此这是一个需要更新的重要文件。此外,它是一个 ruby 文件,所以缩进最好正确!它带有一个预定义的结构,所以这是一个很大的帮助。只需使用相关信息更改所有值即可。
      • 你的pod项目版本s.version必须相同
      • s.summary 必须大于 s.description
      • 中给定的值
      • add s.swift_version = '5.0',就在摘要下方,以避免一些警告
      • s.homepage 应该是您的存储库的路径 (https://github.com/rptwsthi/RPTInteractiveView)
      • s.license = { :type => 'MIT', :file => 'LICENSE' }
      • s.author= { 'Your Name' => 'your@email.com' }
      • s.source 应该类似于 s.source = { :git => 'https://github.com/rptwsthi/RPTInteractiveView.git', :tag => s.version.to_s }。如您所见 :tag => s.version.to_s 这就是为什么我们需要保持我们的 tag 版本与项目版本相同,所以它在所有 3 个地方(项目版本、podspec 版本和我们要使用此版本发布的提交的标签)保持对称。
      • 您可以保留其余参数。
      • 还记得pod lib吗?在您的终端上使用 lint 再次使用它来验证您的 podspec 是否准备就绪。

        $ pod lib lint

      • 如果您正确地按照说明进行操作,您将看到这条甜美的线条 RPTInteractiveView passed validation.,颜色为绿色 ³
    2. 自述文件:此文件是人们使用和不使用您的 pod 的区别。这可以在 Github 上编辑,您可以在本地进行。我更喜欢 GitHub 以交互方式执行此操作。编辑自述文件时您应该了解的一些内容:

      • 要添加屏幕截图(或 gif),请使用代码提交屏幕截图并使用这些图像的 git 路径,同时添加 link
      • 我用https://giphy.com创建了很好的.gif文件来展示交互式的使用,如果你想的话你也可以这样做
      • 必须解释如何使用它,因为虽然对您来说它对其他人来说非常简单,但可能并非如此。
    3. License:许可证文件在这里是为了免除您的责任,并告知用户他们拥有的自由。您必须在此文件中添加您的许可证信息并保存。我用的是麻省理工你可以随便用


第 4 步:推送到远程存储库

  • 为你分支的最新提交添加一个标签,它必须与你的 pod 项目版本相同。
  • 您可以继续在您的 pod 中进行更新并推送到远程 repo 没问题,但是每次您想要将其发布到 podspecs 时,请更新您的 pod 项目的版本创建一个标签并将该标签推送到 repo .稍后我们将在 podspec 文件的 s.version.
  • 中使用相同的值
  • 将你的代码推送到这个 repo 让我们把它保存在分支 master 上。

第 5 步:让它可供其他程序员使用。

  • 你已经完成了你需要做的一切。尊重!现在是时候让全世界看到您创建的一个令人惊叹的豆荚了。您将需要使用 pod trunk.
  • 如果尚未注册,您必须注册 pod t运行k 和 stated here

    pod trunk register your@emai.com 'Your Name' --description='machine name (e.g. MacBook Pro)'
    You must click a link in an email Trunk sends you to verify the connection between your Trunk account and the current computer. You can list your sessions by running pod trunk me.
    Trunk accounts do not have passwords, only per-computer session tokens.

  • 现在您已经注册了,在您的项目文件夹中的终端中 运行:

    pod trunk push RPTInteractiveView.podspec

  • 由于您已完全按照这些步骤操作,因此您一定得到了这样的回复。您可以在此处查看完整的控制台日志


    Congrats

    RPTInteractiveView (0.1.0) successfully published
    February 12th, 19:16
    https://cocoapods.org/pods/RPTInteractiveView
    Tell your friends!



现在怎么办?

现在请稍等,第一次发布您的广告连播可能需要长达 48 小时(我遇到过)。但是去https://github.com/CocoaPods/Specs/commits/master,你会看到这样的东西。

这是一件让您开心并让您有耐心等待的事情。你做到了,为自己感到骄傲。吃点好吃的。


学分:

如何创建自己的 Pod

在 Swift

中创建自定义库

概述

创建 Cocoapods 库 Swift:这个 post 指的是使用 swift 创建自己的 pod,它是自定义的 cocoapod 库。 Xcode 允许使用 swift 创建自己的 cocoapods 库,这意味着创建自己的 iOS 框架,该框架将在全球范围内供其他开发人员使用。开发人员可以通过将此自定义 pod 安装为第三方库来将其用于他们的项目。

创建自定义 Pod:要创建自己的自定义 Pod 并使其 public 仅供其他开发人员使用,我们将使用 Git Hub。由于 Git Hub 是托管我们自定义 pod 并使其 public 可用的最佳媒介。此外 Git Hub 提供了版本控制,用于管理自定义 pod 的不同版本。因此,当用户想要更新他们的自定义 pod 库时,他们可以通过创建新版本和更新他们的自定义 pod 库版本轻松地做到这一点。

在 swift 中创建您自己的库并使其在全球可用。在自己的 Cocoapods 库中自定义 pod。将自己的 pod(自己的库)分发到 iOS 开源社区。 git 上已经有许多不同的开源 (pod) 库可用,例如 Alamofire、SwiftyJSON 等等。在本文中,我们将学习如何通过以下步骤创建自己的 pod(库)-

在这篇文章中,我们将通过以下步骤

要求

  • Xcode 6 或以上
  • Swift 4
  • iOS 9或以上
  • Git 中心帐户或存储库

步骤

  1. 创建一个新的 public 存储库
  2. 为存储库命名并添加描述
  3. 使用自述文件检查初始化
  4. Select MIT 许可证
  5. 点击“创建存储库”开始
  6. 克隆存储库
  7. 点击“克隆或下载按钮”
  8. Select 使用 HTTPS url 克隆并复制 url
  9. 打开新终端 window & select 克隆项目文件夹
  10. 克隆后应该有文件 README.md 和可用的许可文件
  11. 从文件 -> 新建 -> 项目 -> 框架开始 Xcode
  12. 为产品命名,Select 语言 Swift & 单击下一步按钮
  13. 现在 select 用于克隆存储库和保存项目的同一文件夹
  14. 创建一个新的 swift 文件:R单击项目文件夹和 select“新建文件”-> select swift 文件并为文件命名。
  15. 在这个新文件中写下创建自定义 pod 所需的代码。 16. 根据需要,您可以创建任意数量的文件。请记住仅添加需要的文件和需要的代码量以保持库文件的大小及其完整性。查看下面的“注释”部分了解更多信息。
  16. 现在保存代码并按原样关闭项目。
  17. 您可以将这些所有源代码推送到 Git hub。
  18. 打开终端 window 并将目录更改为您的库项目文件夹并写入并点击“return”

‘pod init’

  1. 您还需要添加.podspec 文件。此文件包含有关您的自定义 pod 库的信息。在项目中创建 Podfile 后,现在使用以下命令添加 .podspec 文件,请记住在以下命令中提供您的存储库名称

pod spec create YOURRESPOSITORYNAME

  1. 现在您一定已经在您的项目文件夹中看到“Podfile”和“YOURRESPOSITORYNAME.podspec”文件,您可以从 finder 本身或通过列出文件夹内容来检查这些文件的可用性终端。

  2. 接下来您需要在任何您喜欢的编辑器中打开“YOURRESPOSITORYNAME.podspec”文件。相反,您可以 select Xcode 作为此文件的编辑器。从终端,您可以输入以下命令以在 Xcode 中打开它,或者您可以从 finder & select Xcode as editor

    RClick

open YOURRESPOSITORYNAME.podspec -a Xcode

  1. 这里需要编辑‘YOURRESPOSITORYNAME.podspec’文件。实际上,您需要指定有关 iOS 框架的自定义 pod 库的所有必要细节。

  2. 完成编辑“YOURRESPOSITORYNAME.podspec”文件后,关闭此文件(文件编辑器)并移至终端window。确保您位于包含“YOURRESPOSITORYNAME.podspec”文件的自定义 pod 文件夹的相同路径(相同目录)中。在这里写下以下命令并点击 return

pod spec lint

此命令将使用所有 pod 验证属性验证您的自定义 pod。验证您的 pod 有不同的验证步骤,此验证可能会在任何验证步骤中失败。确保所有验证步骤都应在没有警告的情况下通过。

  1. 有时在验证自定义 pod 时,可能会失败,您最终会收到没有许可证的警告存储库附带的文件虽然您添加了许可证,但这些验证有时无法获得许可证。在这种情况下,您可以像下面这样编写 (--allow-warnings) 命令 -

pod spec lint -- allow-warnings

  1. 验证过程需要一些时间才能完成。验证过程完成后,您将收到绿色文本颜色的消息。

YOURRESPOSITORYNAME.podspec passed validation

  1. 现在您的自定义 pod 可以使用了,您可以通过在 pod 文件中提供本地路径在任何单独的项目上测试此 pod

pod ‘YOURPODNAME’, :path => “YOURLOCALCUSTOMPODPATH”

  1. 成功完成测试后,您必须将自定义 pod 项目的所有源代码推送到 Git Hub。这将是您的自定义广告连播的第一个版本。

  2. 将所有源代码推送到 git 后,您需要使此自定义 pod 全局可用,为此首先使用

    检查 session

pod trunk me

这将显示有关当前 运行 session

的信息
  1. 下一步通过注册您的自定义 pod 设置主干。输入以下命令并点击 return.

pod trunk register YOUREMAILADDRESS ‘YOUR NAME’ — description=’macbook’

请记住,在上面的描述中,在等号和引号内只需写下您拥有的 macbook 类型,“macbook pro”或“macbook air”

  1. 这将显示一条消息,要求您验证您提供的电子邮件地址。为此,您需要打开您提供的电子邮件并找到您从 Cocoapods 收到的确认电子邮件。在这里你会得到 link,点击这个 link & 你将移动到官方 cocoapods 页面将显示你完成自定义 pod 设置。

  2. 最后,return回到终端&写入如下命令完成自定义pod进程

pod trunk push

这将再次验证您的自定义广告连播并检查所有必要的文件。检查后,它将被发布,您将收到祝贺消息。这确认您的自定义广告连播现已在全球可用。

如何更新自定义 Pod


步骤:

  1. 首先对您的自定义 pod 项目进行所有必要的更改并保存项目文件(如果未启用自动保存)。
  2. 将所有这些更改推送到 git 与您的自定义 pod 项目连接的存储库,并进行必要的提交,然后检查存储库中是否有您最近的提交。
  3. 现在打开您的 .podspec 文件并转到版本行并根据要求更新您的自定义 pod 版本。 (注4)
  4. 将 .podspec 版本更新提交到 git 并要求提交。
  5. 接下来是移动到终端并将目录更改为包含 .podspec 文件的自定义 pod 文件夹并编写以下命令

pod spec lint

  1. 自定义 pod 成功 lint 后,转到您的 git 存储库(从浏览器)并单击发布选项为这些新更改创建新版本

  2. 点击“起草新版本”,输入需要的标签版本,给出版本标题,写任何描述,然后点击“发布版本”按钮发布这个新版本。 (注5)

  3. 一旦你的发布成功发布,移动到终端并在同一目录(包含 .podspec 文件)输入以下内容

pod trunk push

  1. 成功推送文件后,您的终端 window 将显示一条带有自定义 pod 名称及其新版本号的祝贺消息。

  2. 现在您可以通过将您的项目根文件夹移动到终端并输入以下内容以使用您当前的新版本更新 pod 来检查您的自定义 pod 的新版本。

pod update

** 注:**

  1. 始终尝试只为库编写必要的代码。大量的代码行会增加库的大小。尽量让它小而紧凑。
  2. 保持源代码在文件中的整洁,不要试图增加代码的复杂性。这对用户来说应该很容易理解并在项目中轻松访问。
  3. 尝试添加注释或注释标记以指定哪些代码用于什么目的。也可以添加开始代码注释和结束代码注释,以指明源代码的特殊性。
  4. 在使用新版本更新自定义 pod 时,始终检查同一个自定义 pod 的旧版本不应得到更新。意味着永远不要尝试用新的更改来更新旧的自定义 pod 版本,尽管其中有一些小的更改,但始终更新您的自定义 pod 版本号。
  5. 您还可以 select 存储库中的特定分支来草拟新版本。唯一的条件是您的新更改应该在您要 select 起草新版本的分支中可用。