Skip to main content

CocoaPods: How to create CocoaPod

https://medium.com/@vialyx/create-cocoapod-using-swift-2685c7f119ac


Như chúng ta đã biết, CocoaPods là một công cụ tuyệt vời và hữu ích, giúp quản lý, chia sẻ các thư viện lập trình một cách hiệu quả trong phát triển ứng dụng iOS, OS X. Số lượng người sử dụng CocoaPods ngày càng nhiều, cộng đồng hỗ trợ ngày càng đông. Các thư viện lập trình phổ biến trong iOS như: AFNetworking, Alamofire, SDWebImage, MBProgressHUD, SwiftyJSON... đều hỗ trợ CocoaPods cả.
Tuy nhiên chúng ta thường chỉ dùng thư viện của người khác qua CocoaPods. Và đã bao giờ bạn tự hỏi: Làm thế nào để tạo ra một pod chia sẻ thư viện của riêng mình? Trong bài viết này, chúng ta sẽ cùng tìm hiểu điều đó.
CocoaPods bản chất là một Ruby gem trong RubyGems. Để cài đặt CocoaPods, mở Terminal lên và chạy đoạn lệnh sau:
sudo gem install cocoapods

Step by Step Overview

Việc tạo một thư viện bằng CocoaPods có thể chia thành 5 bước chính sau:
  1. Xác định ý tưởng, mục đích của thư viện pod mà bạn cần tạo.
  2. Sử dụng các lệnh pod lib để tạo cấu trúc thư mục và các file của pod theo chuẩn.
  3. Update các file metadata: bao gồm thông tin license và version của thư viện.
  4. Code: bao gồm code chính của thư viện và code sample project sử dụng thư viện đó nếu cần.
  5. Public thư viện pod của bạn để những người khác có thể sử dụng.

Practice

Create the Project

Trong Terminal, cd đến thư mục muốn tạo project và chạy lệnh sau:
pod lib create MyFirstPod
Sau đó, CocoaPods sẽ tự động clone pod template từ trên github và tạo giúp chúng ta thư mục project pod chuẩn với các file cần thiết theo template. pod lib create không phải là cách duy nhất để có thể tạo pod, tuy nhiên nó là cách đơn giản và dễ nhất.
Cloning `https://github.com/CocoaPods/pod-template.git` into `MyFirstPod`.
Configuring MyFirstPod template.

------------------------------

To get you started we need to ask a few questions, this should only take a minute.

If this is your first time we recommend running through with the guide: 
 - http://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )


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

Running pod install on your new library.

Analyzing dependencies
Fetching podspec for `MyFirstPod` from `../`
Downloading dependencies
Installing MyFirstPod (0.1.0)
Generating Pods project
Integrating client project

[!] Please close any current Xcode sessions and use `MyFirstPod.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

[!] Automatically assigning platform `ios` with version `9.3` on target `MyFirstPod_Example` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.

 Ace! you're ready to go!
 We will start you off by opening your project in Xcode
  open 'MyFirstPod/Example/MyFirstPod.xcworkspace'

To learn more about the template see `https://github.com/CocoaPods/pod-template.git`.
To learn more about creating a new pod, see `http://guides.cocoapods.org/making/making-a-cocoapod`.
CocoaPods sẽ tiếp tục hỏi một số câu để configure project pod theo ý chúng ta muốn:
  • What platform do you want to use?? [ iOS / macOS ] -> Chọn platform của library đang cần tạo.
  • What language do you want to use?? [ Swift / ObjC ] -> Chọn ngôn ngữ lập trình.
  • Would you like to include a demo application with your library? [ Yes / No ] -> Có muốn tạo cả project sample sử dụng thư viện đang cần tạo không?
  • Which testing frameworks will you use? [ Quick / None ] -> Có muốn sử dụng framework test không? Mặc định sẽ có framework test Quick.
  • Would you like to do view based testing? [ Yes / No ] -> Có muốn tạo các view dựa trên test không?
Sau khi trả lời các câu hỏi này, CocoaPods sẽ tạo project và tự động mở nó lên. Cấu trúc thư mực của thư mục pod như sau:
MyFirstPod
├── Example
│   ├── MyFirstPod
│   ├── MyFirstPod.xcodeproj
│   ├── MyFirstPod.xcworkspace
│   ├── Podfile
│   ├── Podfile.lock
│   ├── Pods
│   └── Tests
├── LICENSE
├── MyFirstPod
│   ├── Assets
│   └── Classes
├── MyFirstPod.podspec
├── README.md
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
  • File _Pods.xcodeproj: shorstcut đến file project Example/Pods/Pods.xcodeproj để hỗ trợ Carthage.
  • Thư mục Example: chứa project sample sử dụng thư viện đang tạo.
  • File LICENSE: file license mặc định theo MIT License.
  • File README.md: file README mặc định được viết bằng markdown.
  • Thư mục MyFirstPod/Assets: chứa các file ảnh... của thư viện pod.
  • Thư mục MyFirstPod/Classes: chứa code chính của thư viện pod.

Updating Pod's Metadata

Metadata của một pod được thể hiện thông qua 3 file:
  • .podspec: file này mô tả thông tin về mỗi version cụ thể của pod. Ví dụ như: pod version, trang chủ và tên tác giả của thư viện này.
  • README.md
  • LICENSE
Dùng Xcode mở file .podspec trong thư mục MyFirstPod/MyFirstPod.podspec lên, nội dung như sau:
Pod::Spec.new do |s|
  s.name             = 'MyFirstPod'
  s.version          = '0.1.0'
  s.summary          = 'A short description of MyFirstPod.'
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://github.com/oNguyenXuanThanh/MyFirstPod'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'oNguyenXuanThanh' => 'thanhfnx@gmail.com' }
  s.source           = { :git => 'https://github.com/oNguyenXuanThanh/MyFirstPod.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'MyFirstPod/Classes/**/*'
  
  # s.resource_bundles = {
  #   'MyFirstPod' => ['MyFirstPod/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end
Chúng ta có thể thấy có rất nhiều thông tin mô tả như: tên pod, version, mô tả ngắn gọn, mô tả đầy đủ, trang chủ, tên, email tác giả, link ảnh, file license, link github source code, link twitter, thư mục source file, thư mục assets, public header files, framework sử dụng, các library sử dụng.
Sau khi sửa các thông tin trên, chạy lệnh pod lib lint MyFirstPod.podspec để validate và đảm bảo các thông tin podspec hợp lệ trước khi submit.
 -> MyFirstPod (0.1.0)
    - WARN  | summary: The summary is not meaningful.
    - WARN  | url: The URL (https://github.com/oNguyenXuanThanh/MyFirstPod) is not reachable.
    - WARN  | [iOS] swift: The validator used Swift 3.2 by default because no Swift version was specified. To specify a Swift version during validation, add the `swift_version` attribute in your podspec. Note that usage of the `--swift-version` parameter or a `.swift-version` file is now deprecated.

[!] MyFirstPod did not pass validation, due to 3 warnings (but you can use `--allow-warnings` to ignore them).
You can use the `--no-clean` option to inspect any issue.
Sửa nội dung trường s.summary, s.description cho hợp lệ, thêm trường s.swift_version = '4.0' vào file .podspec. Trên tài khoản github tạo một repository mới tên MyFirstPod và push code mới nhất lên.
git add .
git commit -m "Initial commit"
git remote add origin git@github.com:oNguyenXuanThanh/MyFirstPod.git
git push -u origin master
Chạy lại lệnh pod lib lint MyFirstPod.podspec, chúng ta sẽ không còn thấy lỗi nữa.
 -> MyFirstPod (0.1.0)

MyFirstPod passed validation.

Adding Code

Ở bước này, chúng ta sẽ thêm code của thư viện vào. Cụ thể, trong Xcode, xóa file ReplaceMe.swift

Trong project này, mình chỉ demo tạo một class custom UITextField cho phép chọn ảnh làm leftView. Thêm file LeftImageTextField.swift như sau vào thư mục MyFirstPod/Classes

import UIKit

class LeftImageTextField: UITextField {
    
    @IBInspectable private var leftImage: UIImage? {
        didSet {
            setLeftView()
        }
    }
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setLeftView()
    }
    
    required init?(coder aDecoder: NSCoder) {
        super.init(coder: aDecoder)
        setLeftView()
    }
    
    private func setLeftView() {
        let leftImageView = UIImageView(image: leftImage)
        if let size = leftImageView.image?.size {
            leftImageView.frame = CGRect(x: 0.0, y: 0.0, width: size.width + 8.0, height: size.height)
        }
        leftImageView.contentMode = .right
        leftViewMode = .always
        leftView = leftImageView
    }
    
}
Bước tiếp theo, chúng ta sẽ test thử class LeftImageTextField trong sample project. Quay lại Terminal, cd vào thư mục Example và chạy lệnh pod install.
cd Example
pod install
Analyzing dependencies
Fetching podspec for `MyFirstPod` from `../`
Downloading dependencies
Installing MyFirstPod 0.1.0 (was 0.1.0)
Generating Pods project
Integrating client project
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

[!] Automatically assigning platform `ios` with version `9.3` on target `MyFirstPod_Example` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.
Trong thư mục Example, file podfile cũng sẽ khác so với khi chúng ta vẫn hay dùng pod library trên github.
use_frameworks!

target 'MyFirstPod_Example' do
  pod 'MyFirstPod', :path => '../'

  target 'MyFirstPod_Tests' do
    inherit! :search_paths

    
  end
end
Cocoapods sẽ tạo pod từ đường dẫn "../" chứ không phải từ remote repository như bình thường.
Mở file Main.storyboard trong example project lên và kéo thả một UITextField mới vào, set custom class thành LeftImageTextField.

Chọn ảnh cho property leftView, chạy thử app sample, kết quả:

Publish Pod

Tagging

Bước đầu tiên là commit code hiện tại, gắn tag cho nó và push lên remote. Tên tag nên đặt là tên version s.version trong file .podspec.
git tag 0.1.0
git push origin 0.1.0
Total 0 (delta 0), reused 0 (delta 0)
To github.com:oNguyenXuanThanh/MyFirstPod.git
 * [new tag]         0.1.0 -> 0.1.0

Validation

Tiếp theo, chạy lại lệnh pod spec lint MyFirstPod.podspec để validate .podspec một lần nữa.
pod spec lint MyFirstPod.podspec

 -> MyFirstPod (0.1.0)

Analyzed 1 podspec.

MyFirstPod.podspec passed validation.

Pushing to Specs Repository

Để đăng ký session, chúng ta dùng lệnh:
pod trunk register nguyenkhiem7789@gmail.com 'Nguyen Khiem'
[!] Please verify the session by clicking the link in the verification email that has been sent to thanhfnx@gmail.com
Vào email của bạn và hoàn thành việc đăng ký. Cuối cùng, chúng ta cần push .podspec lên Specs repository của CocoaPods bằng lệnh:
pod trunk push MyFirstPod.podspec

[ ! ] Chú ý là tên pod của bạn phải không được trùng với bất kỳ pod nào đã có trước đó nhé.
Nếu không muốn bị như này:
pod trunk push MyFirstPod.podspec
Updating spec repo `master`
warning: inexact rename detection was skipped due to too many files.
Validating podspec
 -> MyFirstPod (0.1.0)

[!] {"name"=>["is already taken"]}

Comments

Post a Comment

Popular posts from this blog

MVVM và VIPER: Con đường trở thành Senior

Trong bài viết trước chúng ta đã tìm hiểu về MVC và MVP để ứng dụng cho một iOS App đơn giản. Bài này chúng ta sẽ tiếp tục ứng dụng 2 mô hình MVVM và VIPER . Nhắc lại là ứng dụng của chúng ta cụ thể khi chạy sẽ như sau: Source code đầy đủ cho tất cả mô hình MVC, MVP, MVVM và VIPER các bạn có thể download tại đây . MVVM MVVM có thể nói là mô hình kiến trúc được rất nhiều các cư dân trong cộng đồng ưa chuộng. Điểm tinh hoa của kiến trúc này là ở ViewModel , mặc dù rất giống với Presenter trong MVP tuy nhiên có 2 điều làm nên tên tuổi của kiến trúc này đó là: ViewModel không hề biết gì về View , một ViewModel có thể được sử dụng cho nhiều View (one-to-many). ViewModel sử dụng Observer design pattern để liên lạc với View (thường được gọi là binding data , có thể là 1 chiều hoặc 2 chiều tùy nhu cầu ứng dụng). Chính đặc điểm này MVVM thường được phối hợp với các thư viện hỗ trợ Reactive Programming hay Event/Data Stream , đây là triết lý lập trình hiện đại và hiệu...
Post a Comment
Read more

Alamofire vs URLSession

Alamofire vs URLSession: a comparison for networking in Swift Alamofire and URLSession both help you to make network requests in Swift. The URLSession API is part of the foundation framework, whereas Alamofire needs to be added as an external dependency. Many  developers  doubt  whether it’s needed to include an extra dependency on something basic like networking in Swift. In the end, it’s perfectly doable to implement a networking layer with the great URLSession API’s which are available nowadays. This blog post is here to compare both frameworks and to find out when to add Alamofire as an external dependency. Build better iOS apps faster Looking for a great mobile CI/CD solution that has tons of iOS-specific tools, smooth code signing, and even real device testing? Learn more about Bitrise’s iOS specific solutions! This shows the real power of Alamofire as the framework makes a lot of things easier. What is Alamofire? Where URLSession...
Post a Comment
Read more

Frame vs Bounds in iOS

This article is a repost of an answer I wrote on Stack Overflow . Short description frame = a view’s location and size using the parent view’s coordinate system ( important for placing the view in the parent) bounds = a view’s location and size using its own coordinate system (important for placing the view’s content or subviews within itself) Details To help me remember frame , I think of a picture frame on a wall . The picture frame is like the border of a view. I can hang the picture anywhere I want on the wall. In the same way, I can put a view anywhere I want inside a parent view (also called a superview). The parent view is like the wall. The origin of the coordinate system in iOS is the top left. We can put our view at the origin of the superview by setting the view frame’s x-y coordinates to (0, 0), which is like hanging our picture in the very top left corner of the wall. To move it right, increase x, to move it down increase y. To help me remember bound...
Post a Comment
Read more