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:
pod trunk push --allow-warnings
Nguồn tham khảo: https://betterprogramming.pub/how-to-create-a-public-cocoapods-library-23e9c8f773f8
All rights reserved