Đã đăng vào thg 5 11, 2021 3:42 SA 4 phút đọc

224

Tạo thư viện Public trên CocoaPods

Bài đăng này đã không được cập nhật trong 3 năm

Bạn có thể đã được hưởng lợi từ các thư viện của bên thứ ba mà người khác đã tạo. Thư viện của bên thứ ba có thể giúp bạn tiết kiệm rất nhiều thời gian khi xây dựng ứng dụng vì chúng là plug and play. Thư viện của bên thứ ba cũng có tên khác với các phần phụ thuộc. Trình quản lý Dependency phổ biến và được sử dụng rộng rãi nhất là CocoaPods. CocoaPods có hơn 82.000 thư viện và còn tiếp tục tăng, và đang được sử dụng trong hơn ba triệu ứng dụng. Bạn có thể chọn tạo thư viện bên thứ ba công khai hoặc riêng tư. Thư viện công cộng có thể được sử dụng bởi những người khác, những người sau đó có thể đề xuất các cải tiến cho Code của bạn. Mặt khác, một Private library chỉ có sẵn cho dự án của bạn.

Điều kiện tiên quyết

Để làm theo hướng dẫn này, bạn sẽ cần một số kiến thức cơ bản về:

Kiến thức cơ bản về Swift
Kiến thức cơ bản về Git
Xcode 12

Tạo CocoaPods

Cài đặt CocoaPods lên máy và chạy câu lệnh sau:

pod lib create Ulti

Bạn sẽ được hỏi năm câu hỏi - trả lời theo nhu cầu của bạn nhưng hiện tại, đây là những gì chúng ta sẽ làm:

Project của bạn sẽ tự mở ra. Hãy xem qua dự án của bạn. Cuối cùng, bạn chỉ nên quan tâm các phần sau:

Thư mục này chứa các tệp mà bạn cần để định cấu hình thông tin về Pod của mình như lập phiên bản, mô tả, readme, v.v.
Thư mục này là nơi bạn cung cấp ví dụ về cách sử dụng Code của mình. Điều này để những người khác biết cách sử dụng Pod của bạn.
Đây là nơi đặt Code của bạn- cụ thể là bên trong các Development Pods

Tiếp theo, hãy chèn code vào Development Pods để bất kỳ ai quyết định sử dụng Ulti đều có thể sử dụng Code mà ta đã thêm. Bạn có thể tạo một tệp mới bên trong Development Pods > Ulti

Về cơ bản, Code này cho phép bạn thêm corner radios, border, v.v.

import UIKit

extension UIView {
    public func addCornerRadius(_ radius: CGFloat = 16) {
        layer.cornerRadius = radius
        layer.masksToBounds = true
    }

    public func addBorderLine(width: CGFloat = 1, color: UIColor = UIColor.black.withAlphaComponent(0.1)) {
        layer.borderWidth = width
        layer.borderColor = color.cgColor
    }

    public func makeRounded() {
        layer.masksToBounds = false
        layer.cornerRadius = self.frame.height / 2
        clipsToBounds = true
    }

    @objc public func addShadow(cornerRadius: CGFloat = 16,
                         shadowColor: UIColor = UIColor.black,
                         shadowOffset: CGSize = CGSize(width: 0, height: 4),
                         shadowOpacity: Float = 0.1,
                         shadowRadius: CGFloat = 6) {
        layer.cornerRadius = cornerRadius
        layer.shadowColor = shadowColor.cgColor
        layer.shadowOffset = shadowOffset
        layer.shadowOpacity = shadowOpacity
        layer.shadowRadius = shadowRadius
    }
}

Host Your Code on GitHub

Bạn có thể chọn lưu trữ nó ở bất cứ đâu bạn muốn trên GitHub.

Push to CocoaPods

Cuối cùng, bạn có thể đẩy Pod của mình sang CocoaPods để mọi người khác có thể sử dụng Code của bạn.

Vì chúng ta đã tag version là 0.0.1, chúng ta cần thay đổi version trên Ulti.podspec để version phù hợp với tag.

s.version = '0.0.1'

Khi bạn đã thiết lập những điều đó, bạn có thể khởi chạy lệnh sau để làm cho nó public.

pod trunk push --allow-warnings

Share Example Codes

Bạn cần phải ở bên trong thư mục Example và cài đặt Pod bằng cách nhập lệnh sau.

pod install

Bây giờ bạn có thể sử dụng code từ Development Pods. Tiếp theo, bạn cần import pod

import Ulti

class ViewController: UIViewController {

   @IBOutlet private weak var mainView: UIView!
  
   override func viewDidLoad() {
       super.viewDidLoad()
      
       mainView.backgroundColor = .green
       mainView.addShadow()
       mainView.addCornerRadius()
   }
}

Khi chạy Project, bạn sẽ thấy shadow với corner radious:

Các Dev sẽ biết cách sử dụng Code của bạn bằng cách xem ví dụ. Điều này sẽ rất hữu ích cho họ!

Push CocoaPods Update

Tiếp theo, bạn cần đẩy code sang chế độ công khai để người khác có thể truy cập vào các thay đổi mới nhất.

Bên trong GitHub, bạn phải tạo Release note với version number khớp với tag và version number bên trong podspec.

Publish release.

Tiếp theo, bên trong Ulti.podspec, update version:

s.version = '0.0.2'

Sau đó, bạn cần thực hiện lệnh Git:

git add .
git commit -m "Added Example"
git tag -a 0.0.2 -m "Version 0.0.2"
git push

Cuối cùng, đẩy nó sang CocoaPods: