CocoaPods: মূল ধারণা, iOS-এর জন্য নির্ভরতা ব্যবস্থাপক

CocoaPods কী?

CocoaPods হলো Apple ইকোসিস্টেমের জন্য একটি নির্ভরতা ব্যবস্থাপক, যা Ruby-তে লেখা এবং 2011 সালে Eladio Lopez দ্বারা প্রকাশিত। CocoaPods Xcode প্রজেক্টে তৃতীয়-পক্ষের লাইব্রেরি সংহতকরণের সমস্যা সমাধান করে: ম্যানুয়ালি ফাইল কপি করা এবং লিঙ্কার ফ্ল্যাগ কনফিগার করার পরিবর্তে, ডেভেলপার Podfile-এ নির্ভরতা বর্ণনা করে এবং pod install চালায়। CocoaPods স্বয়ংক্রিয়ভাবে সোর্স ফাইল ডাউনলোড করে, কম্পাইলার ফ্ল্যাগ কনফিগার করে এবং .xcworkspace ওয়ার্কস্পেস তৈরি করে।

CocoaPods আর্কিটেকচারে তিনটি উপাদান রয়েছে: CocoaPods.app (CLI টুল), Specs (GitHub-এ কেন্দ্রীয় স্পেসিফিকেশন রেজিস্ট্রি), এবং Podfile (প্রজেক্ট কনফিগারেশন)। Specs রেজিস্ট্রিতে সংস্করণ ইতিহাস সহ 100,000-এরও বেশি লাইব্রেরি রয়েছে। pod install চালানোর সময়, CocoaPods সর্বশেষ রেজিস্ট্রি সংস্করণ ডাউনলোড করে (pod repo update), নির্ভরতা খুঁজে বের করে, সংস্করণ ট্রি সমাধান করে এবং সমস্ত pod ইন্টিগ্রেশন সহ .xcworkspace তৈরি করে। প্রতিটি লাইব্রেরি একটি পৃথক টার্গেট হিসেবে কম্পাইল করা হয়, যা নির্ভরতা বিচ্ছিন্নকরণ এবং নাম দ্বন্দ্ব এড়াতে সাহায্য করে।

CocoaPods Xcode-এর সাথে নিবিড়ভাবে সংহত: এটি হেডার পাথ এবং লিঙ্কার ফ্ল্যাগ সহ Pods.xcconfig ফাইল তৈরি করে এবং User Script Sandboxing কনফিগার করে। macOS-এ CocoaPods ব্যবহার করতে Ruby 2.6+ (সমস্ত Mac-এ প্রি-ইনস্টল) এবং Xcode with Command Line Tools প্রয়োজন। পরিসংখ্যান: 2025 সালে, CocoaPods 10 বিলিয়নেরও বেশি pod ডাউনলোড প্রক্রিয়া করেছে, এবং গড় iOS প্রজেক্টে CocoaPods-এর মাধ্যমে 15 থেকে 40টি নির্ভরতা থাকে।

CocoaPods কীভাবে কাজ করে

CocoaPods প্রতিটি লাইব্রেরি একটি পৃথক Git রিপোজিটরি হিসেবে ডাউনলোড করে, এর .podspec স্পেসিফিকেশন যাচাই করে এবং এটি একটি স্ট্যাটিক ফ্রেমওয়ার্ক বা ডায়নামিক লাইব্রেরিতে কম্পাইল করে। Pods অন্যান্য pods-এর উপর নির্ভর করতে পারে — CocoaPods একটি নির্ভরতা গ্রাফ তৈরি করে এবং সংস্করণ দ্বন্দ্ব সমাধান করে। যদি দুটি লাইব্রেরির একই নির্ভরতার ভিন্ন সংস্করণের প্রয়োজন হয়, CocoaPods একটি সামঞ্জস্যপূর্ণ সংস্করণ খোঁজার চেষ্টা করে বা ত্রুটি রিপোর্ট করে। সমস্ত নির্ভরতা এবং তাদের সংস্করণ Podfile.lock ফাইলে রেকর্ড করা হয়, যা সংস্করণ নিয়ন্ত্রণে যুক্ত করা উচিত।

ম্যানুয়াল ইন্টিগ্রেশনের তুলনায় CocoaPods-এর সুবিধা: স্বয়ংক্রিয় নির্ভরতা ব্যবস্থাপনা, কেন্দ্রীভূত লাইব্রেরি রেজিস্ট্রি, সাবস্পেস (subspecs) সমর্থন, প্রাইভেট রিপোজিটরি তৈরি করার ক্ষমতা এবং সেম্যান্টিক ভার্সনিং। একটি ডেভেলপমেন্ট টিমের জন্য, CocoaPods নিশ্চিত করে যে সকল সদস্য একই লাইব্রেরি সংস্করণ ব্যবহার করে — Podfile.lock যেকোনো মেশিনে বিল্ড পুনরুত্পাদনযোগ্যতা নিশ্চিত করে।

Podfile: গঠন, সিনট্যাক্স এবং উদাহরণ

Podfile হলো একটি Ruby কনফিগারেশন ফাইল যা Xcode প্রজেক্টের নির্ভরতা নির্ধারণ করে। Podfile .xcodeproj-এর পাশে প্রজেক্ট রুটে স্থাপন করা হয়। CocoaPods সিনট্যাক্স Ruby DSL (Domain Specific Language) ভিত্তিক, যা ভেরিয়েবল, শর্ত এবং লুপ ব্যবহারের অনুমতি দেয়। একটি ন্যূনতম Podfile-এ একটি প্ল্যাটফর্ম এবং কমপক্ষে একটি নির্ভরতা থাকে।

platform :ios, '15.0'

target 'MyApp' do
  pod 'Alamofire', '~> 5.9'
  pod 'SnapKit', '~> 5.7'
  pod 'Kingfisher', '~> 8.0'
end

মূল লাইন platform :ios, '15.0' ন্যূনতম iOS সংস্করণ নির্ধারণ করে। target 'MyApp' নির্দেশ একটি নির্দিষ্ট টার্গেটের জন্য নির্ভরতা গ্রুপ করে। প্রতিটি pod 'Name', '~> version' লাইন লাইব্রেরির নাম এবং সংস্করণ নির্দিষ্ট করে। অপারেটর '~> 5.9' মানে "5.9 থেকে 6.0 পর্যন্ত যেকোনো সংস্করণ, 6.0 বাদে" — এটি সেম্যান্টিক ভার্সনিং যা ব্রেকিং চেঞ্জ থেকে রক্ষা করে।

সংস্করণ লকিং এবং অপশন

CocoaPods নমনীয় সংস্করণ অপারেটর সমর্থন করে: '= 1.0' (সঠিক সংস্করণ), '>= 1.0' (সর্বনিম্ন), '< 2.0' (সর্বোচ্চ), '~> 1.2.3' (শুধু প্যাচ)। লোকাল ফোল্ডার থেকে লাইব্রেরি অন্তর্ভুক্ত করতে pod 'MyLib', :path => '../MyLib' ব্যবহার করুন। Git থেকে অন্তর্ভুক্ত করতে — pod 'MyLib', :git => 'https://github.com/user/MyLib.git', :tag => '1.0.0'।

platform :ios, '15.0'
use_frameworks! :linkage => :static
inhibit_all_warnings!

target 'MyApp' do
  pod 'Alamofire', '~> 5.9'
  pod 'Firebase/Crashlytics', '~> 11.0'

  target 'MyAppTests' do
    inherit! :search_paths
    pod 'Nimble', '~> 13.0'
  end
end

target 'MyWatchExtension' do
  platform :watchos, '9.0'
  pod 'Alamofire', '~> 5.9'
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
    end
  end
end

use_frameworks! স্ট্যাটিক লাইব্রেরির পরিবর্তে ফ্রেমওয়ার্ক হিসেবে pods তৈরি করতে সক্ষম করে (Xcode 15+ থেকে ডিফল্ট আচরণ)। :linkage => :static অ্যাট্রিবিউট ফ্রেমওয়ার্ককে স্ট্যাটিক হতে বাধ্য করে, অ্যাপের আকার হ্রাস করে। inhibit_all_warnings! pods থেকে সতর্কতা দমন করে — পরিষ্কার বিল্ড লগের জন্য উপযোগী। inherit! :search_paths সহ নেস্টেড টার্গেট (যেমন পরীক্ষার জন্য) সমস্ত নির্ভরতা পুনরায় কম্পাইল না করে শুধু সার্চ পাথ পায়। post_install ব্লক সমস্ত pod টার্গেটের জন্য বিল্ড সেটিংস কনফিগার করে — এটি একটি একীভূত ন্যূনতম iOS সংস্করণ নির্ধারণের জন্য একটি আদর্শ প্যাটার্ন।

Podfile.lock pod install-এর সময় স্বয়ংক্রিয়ভাবে উৎপন্ন হয়। এটি ট্রানজিটিভ সহ সমস্ত ইনস্টল করা নির্ভরতার সঠিক সংস্করণ লক করে। লক ফাইলটি রিপোজিটরিতে রাখা উচিত — এটি ছাড়া, অন্য মেশিনে pod install ভিন্ন সংস্করণ ইনস্টল করতে পারে। কমান্ড pod update PodName একটি নির্দিষ্ট pod আপডেট করে, Podfile.lock পরিবর্তন করে। pod outdated নতুন সংস্করণ উপলব্ধ pods-এর তালিকা দেখায়।

Podspec: লাইব্রেরি তৈরি এবং প্রকাশনা

Podspec হলো .podspec এক্সটেনশন সহ একটি Ruby ফাইল যা CocoaPods-এর জন্য একটি লাইব্রেরি বর্ণনা করে। Podspec-এ মেটাডেটা (নাম, সংস্করণ, লেখক), সোর্স কোড, নির্ভরতা, সিস্টেম ফ্রেমওয়ার্ক এবং প্ল্যাটফর্ম প্রয়োজনীয়তা থাকে। CocoaPods রেজিস্ট্রিতে প্রকাশের আগে pod spec lint দিয়ে podspec যাচাই করে।

Pod::Spec.new do |s|
  s.name             = 'NetworkingKit'
  s.version          = '1.2.0'
  s.summary          = 'Lightweight HTTP client for iOS'
  s.description      = 'NetworkingKit is a Swift HTTP client with async/await support, built-in caching, and automatic retry logic.'
  s.homepage         = 'https://github.com/user/NetworkingKit'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Developer' => 'dev@example.com' }
  s.source           = { :git => 'https://github.com/user/NetworkingKit.git', :tag => s.version.to_s }
  s.ios.deployment_target = '15.0'
  s.swift_version    = '5.9'
  s.source_files     = 'Sources/**/*.swift'
  s.dependency 'Alamofire', '~> 5.9'
end

s.name — রেজিস্ট্রিতে অনন্য লাইব্রেরির নাম। s.version Git ট্যাগের সাথে মিলে (প্রকাশনার জন্য গুরুত্বপূর্ণ)। s.source_files — সোর্স ফাইল অন্তর্ভুক্ত করার জন্য গ্লোব প্যাটার্ন। s.dependency একটি সংস্করণ সহ অন্যান্য pods-এর উপর নির্ভরতা নির্দিষ্ট করে। s.ios.deployment_target ন্যূনতম সমর্থিত iOS সংস্করণ নির্ধারণ করে — যদি প্রজেক্ট পুরানো সংস্করণ ব্যবহার করে তাহলে CocoaPods স্বয়ংক্রিয়ভাবে সতর্ক করবে। প্রাইভেট pods-এর জন্য, রেজিস্ট্রিতে প্রকাশ না করে Podfile-এ :path ব্যবহার করা যেতে পারে।

কেন্দ্রীয় Specs রেজিস্ট্রিতে লাইব্রেরি প্রকাশ করা হয় pod trunk push NetworkingKit.podspec-এর মাধ্যমে। pod trunk register dev@example.com 'Developer'-এর মাধ্যমে পূর্ব নিবন্ধন প্রয়োজন। CocoaPods podspec যাচাই করে এবং Specs রিপোজিটরিতে পুল রিকোয়েস্ট পাঠায়। অভ্যন্তরীণ কোম্পানির লাইব্রেরির জন্য pod repo push-এর মাধ্যমে প্রাইভেট রেজিস্ট্রি একটি বিকল্প।

সাবস্পেস এবং মডুলারিটি

সাবস্পেস (Subspecs) একটি লাইব্রেরিকে মডিউলে বিভক্ত করতে দেয় যা ব্যবহারকারীরা নির্বাচনীভাবে অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ, Firebase সাবস্পেস ব্যবহার করে: pod 'Firebase/Crashlytics' অন্যান্য Firebase মডিউল ছাড়া শুধুমাত্র Crashlytics অন্তর্ভুক্ত করে। সাবস্পেস বেস কনফিগারেশন উত্তরাধিকার সূত্রে পায় এবং নিজস্ব source_files এবং নির্ভরতা যোগ করতে পারে।

CocoaPods ইনস্টল এবং কনফিগার করা

CocoaPods RubyGems-এর মাধ্যমে ইনস্টল করা হয় — Ruby-র স্ট্যান্ডার্ড প্যাকেজ ম্যানেজার। macOS-এ Ruby প্রি-ইনস্টল, তাই একটি টার্মিনাল কমান্ড যথেষ্ট। একটি বিকল্প হলো Homebrew, যা CocoaPods-কে একটি পৃথক ফর্মুলা হিসেবে ইনস্টল করে। ইনস্টলেশনের পর, প্রজেক্ট আরম্ভ করা হয় pod init দিয়ে, যা বেসিক কনফিগারেশন সহ Podfile তৈরি করে। Podfile নির্ভরতা দিয়ে পূরণ করার পর, ডেভেলপার pod install চালায় — CocoaPods লাইব্রেরি ডাউনলোড করে এবং ওয়ার্কস্পেস তৈরি করে।

# ইনস্টল CocoaPods এর মাধ্যমে RubyGems
sudo gem install cocoapods

# বিকল্প ইনস্টল Homebrew
brew install cocoapods

# আরম্ভ Podfile প্রজেক্টে
cd /path/to/Project
pod init

# নির্ভরতা ইনস্টল করা
pod install

গুরুত্বপূর্ণ নিয়ম: pod install-এর পরে, সর্বদা .xcworkspace খুলুন, .xcodeproj নয়। যদি আপনি .xcodeproj খোলেন, Xcode pods দেখতে পাবে না এবং লিঙ্কার ত্রুটির সাথে বিল্ড ব্যর্থ হবে। pod install কমান্ড শুধুমাত্র Podfile পরিবর্তন হলে বা প্রথমবার চালানোর সময় নির্ভরতা ডাউনলোড করে। সমস্ত pods জোর করে পুনরায় ইনস্টল করতে, pod install --repo-update বা pod deintegrate && pod install ব্যবহার করুন।

CocoaPods আপডেট করা হয় sudo gem update cocoapods বা brew upgrade cocoapods-এর মাধ্যমে। CocoaPods সংস্করণ pod --version কমান্ড দিয়ে পরীক্ষা করা হয়। সংস্করণ 1.12 (2024) থেকে, CocoaPods কঠোর মডিউল যাচাই সেটিংস এবং উন্নত ট্রানজিটিভ নির্ভরতা সমাধান সহ Xcode 15 সমর্থন করে। মধ্যম-2025 পর্যন্ত সর্বশেষ স্থিতিশীল সংস্করণ 1.16 যা Swift 6 সমর্থন এবং 50+ pods সহ প্রজেক্টের জন্য উন্নত নির্ভরতা গ্রাফ সমাধান কর্মক্ষমতা সহ।

# সব pods সর্বশেষ সংস্করণে আপডেট করা
pod update

# নির্দিষ্ট pod আপডেট করা
pod update Alamofire

# পুরানো নির্ভরতা পরীক্ষা করা
pod outdated

# অপসারণ CocoaPods প্রজেক্ট থেকে
pod deintegrate

pod update আর্গুমেন্ট ছাড়া Podfile অনুযায়ী সমস্ত pods সর্বশেষ সামঞ্জস্যপূর্ণ সংস্করণে আপডেট করে (~> অপারেটর সম্মান করে)। pod outdated Podfile.lock-এ বর্তমান সংস্করণ এবং সর্বশেষ উপলব্ধ সংস্করণের মধ্যে পার্থক্য দেখায়। pod deintegrate প্রজেক্ট থেকে CocoaPods সম্পূর্ণরূপে সরিয়ে দেয় — .xcworkspace, কনফিগারেশন ফাইল এবং বিল্ড সেটিংস সরিয়ে দেয়। Swift Package Manager-এ মাইগ্রেট করার সময় এটি উপযোগী।

নির্ভরতা এবং সংস্করণ ব্যবস্থাপনা

নির্ভরতা ব্যবস্থাপনা CocoaPods-এ চারটি দিক অন্তর্ভুক্ত: সংস্করণ লকিং, দ্বন্দ্ব সমাধান, বিল্ড অপ্টিমাইজেশন এবং ট্রানজিটিভ নির্ভরতা পরিচালনা। CocoaPods Podfile.lock-এর ভিত্তিতে একটি নির্ভরতা গ্রাফ তৈরি করে — যদি একটি প্রজেক্ট A এবং B লাইব্রেরি ব্যবহার করে, উভয়ই C-এর উপর নির্ভরশীল, CocoaPods C-এর একটি সংস্করণ খুঁজে পায় যা উভয় প্রয়োজনীয়তা পূরণ করে।

দ্বন্দ্ব দেখা দেয় যখন দুটি নির্ভরতা একই লাইব্রেরির অসামঞ্জস্যপূর্ণ সংস্করণের প্রয়োজন হয়। CocoaPods বিরোধপূর্ণ প্রয়োজনীয়তা নির্দেশ করে একটি ত্রুটি রিপোর্ট করে। সমাধান: একটি নির্ভরতাকে সামঞ্জস্যপূর্ণ সংস্করণে আপডেট করুন, একটি নির্দিষ্ট কমিট সহ pod 'Lib', :git => ... ব্যবহার করুন, বা পরিবর্তিত নির্ভরতা সহ একটি লাইব্রেরি ফর্ক করুন। বড় প্রজেক্টের জন্য, প্রতিটি পুল রিকোয়েস্টে pod lib lint সহ CI যাচাই সেটআপ করার পরামর্শ দেওয়া হয়।

উন্নত ব্যবস্থাপনা কৌশল

CocoaPods বেশ কিছু উন্নত ক্ষমতা প্রদান করে: স্থানীয় লাইব্রেরি ডেভেলপমেন্টের জন্য :path, ফর্ক সংযোগের জন্য :git, ডেভেলপমেন্ট ব্রাঞ্চ পরীক্ষার জন্য :branch। :linkage => :static সহ use_frameworks! নির্দেশ চূড়ান্ত বাইনারি আকার কমিয়ে দেয়। A/B পরীক্ষা এবং ফিচার ফ্ল্যাগের জন্য, Podfile-এ Ruby শর্তসাপেক্ষ নির্মাণের মাধ্যমে বিভিন্ন pod সংস্করণ অন্তর্ভুক্ত করা যেতে পারে।

platform :ios, '15.0'
use_frameworks!

# পরিবেশ নির্ধারণ
is_debug = defined?(DEBUG) && DEBUG

target 'MyApp' do
  # মূল নির্ভরতা
  pod 'Alamofire', '~> 5.9'
  pod 'SnapKit', '~> 5.7'

  # ডেভেলপমেন্টের জন্য স্থানীয় লাইব্রেরি
  pod 'MyInternalLib', :path => '../MyInternalLib'

  # ডিবাগিংয়ের জন্য শর্তসাপেক্ষ নির্ভরতা
  if is_debug
    pod 'SwiftyBeaver', '~> 2.0'
  else
    pod 'CocoaLumberjack', '~> 3.8'
  end

  # বাগ ফিক্স সহ ফর্ক
  pod 'Kingfisher', :git => 'https://github.com/user/Kingfisher.git', :branch => 'fix-memory-leak'
end

abstract_target 'Pods' do
  pod 'Alamofire'
end

abstract_target একটি নির্দিষ্ট Xcode টার্গেটের সাথে আবদ্ধ না হয়ে ভাগ করা নির্ভরতার জন্য একটি ভার্চুয়াল টার্গেট তৈরি করে। Ruby শর্তসাপেক্ষ নির্মাণ Debug এবং Release কনফিগারেশনের জন্য বিভিন্ন লাইব্রেরি অন্তর্ভুক্ত করার অনুমতি দেয়। স্থানীয় লাইব্রেরির সাথে :path ডেভেলপমেন্ট ত্বরান্বিত করে — pod install পুনরায় চালু না করেই পরিবর্তন প্রয়োগ হয়। :branch মোড অফিসিয়াল রিলিজের আগে পরিবর্তন পরীক্ষার জন্য উপযোগী।

CocoaPods বনাম Swift Package Manager বনাম Carthage

CocoaPods, Swift Package Manager (SPM) এবং Carthage হলো iOS ডেভেলপমেন্টের তিনটি প্রধান নির্ভরতা ব্যবস্থাপক। প্রতিটির নিজস্ব আর্কিটেকচার, ইন্টিগ্রেশন পদ্ধতি এবং নিয়ন্ত্রণ স্তর রয়েছে। CocoaPods লাইব্রেরির সংখ্যায় নেতৃত্ব দেয়, SPM Xcode-এ অন্তর্নির্মিত সমর্থনে জয়ী, Carthage জনপ্রিয়তায় পিছিয়ে কিন্তু সর্বোচ্চ নিয়ন্ত্রণ দেয়।

CocoaPods সেই প্রজেক্টের জন্য পছন্দ হিসেবে রয়ে গেছে যেখানে সর্বোচ্চ লাইব্রেরি সামঞ্জস্য প্রয়োজন (অনেক লিগ্যাসি লাইব্রেরি শুধুমাত্র CocoaPods-এর মাধ্যমে উপলব্ধ)। SPM নতুন প্রজেক্টের জন্য সুপারিশ করা হয় — এটি Xcode-এ অন্তর্নির্মিত, অতিরিক্ত টুলের প্রয়োজন নেই এবং Apple সমর্থিত। Carthage খুব কমই ব্যবহৃত হয়, মূলত সেই প্রজেক্টের জন্য যেখানে Xcode কনফিগারেশনে ন্যূনতম হস্তক্ষেপ প্রয়োজন। 2024 থেকে, Apple সক্রিয়ভাবে SPM উন্নয়ন করছে, এবং অনেক জনপ্রিয় লাইব্রেরি (Alamofire, Firebase, SnapKit) ইতিমধ্যে CocoaPods-এর পাশাপাশি এটি সমর্থন করে।

CocoaPods থেকে SPM-এ মাইগ্রেশন pod deintegrate (CocoaPods সরানো) এবং Xcode-এ File → Add Package Dependencies-এর মাধ্যমে প্যাকেজ যোগ করে করা হয়। প্রধান চ্যালেঞ্জ: রিসোর্সযুক্ত লাইব্রেরি (ফন্ট, ইমেজ, স্টোরিবোর্ড) ভিন্ন আচরণ করতে পারে, এবং CocoaPods প্লাগইন (যেমন কোড জেনারেশনের জন্য) SPM-এ সমতুল্য নেই। CocoaPods-নির্দিষ্ট বৈশিষ্ট্য প্রয়োজন এমন প্রজেক্টের জন্য CocoaPods রাখার পরামর্শ দেওয়া হয়: কোড জেনারেশন, resource bundles এবং post_install hooks-এর মাধ্যমে কাস্টম বিল্ড ফেজ।

সাধারণ সমস্যা এবং তাদের সমাধান

CocoaPods একটি স্থিতিশীল টুল, কিন্তু ডেভেলপাররা সময়ে সময়ে সাধারণ সমস্যার সম্মুখীন হন। বেশিরভাগ Ruby সংস্করণ, ক্যাশিং বা নির্ভরতা দ্বন্দ্বের সাথে সম্পর্কিত। নীচে সবচেয়ে সাধারণ পরিস্থিতি এবং তাদের সমাধান দেওয়া হল।

ত্রুটি "The sandbox is not in sync with the Podfile.lock" — ঘটে যখন pod install চালানোর আগে Podfile.lock রিপোজিটরিতে পরিবর্তন করা হয়। সমাধান: pod install বা pod deintegrate && pod install চালান। CI পরিবেশের জন্য, বিল্ড স্ক্রিপ্টে pod install যোগ করার পরামর্শ দেওয়া হয়। আরেকটি সাধারণ কারণ ডেভেলপারদের মধ্যে CocoaPods সংস্করণের পার্থক্য: সমস্ত মেশিনে pod --version পরীক্ষা করুন।

Specs রেজিস্ট্রি আপডেট করতে ত্রুটি — সাধারণত নেটওয়ার্ক সমস্যা বা পুরানো Git রিপোজিটরির কারণে। সমাধান: pod repo update --verbose বিস্তারিত দেখায়। যদি Specs দূষিত হয়: rm -rf ~/.cocoapods/repos/master && pod repo add master https://github.com/CocoaPods/Specs.git। ধীর ইন্টারনেটের জন্য, আপনি CDN ব্যবহার করতে পারেন — এটি CocoaPods 1.8+ থেকে ডিফল্টরূপে সক্রিয়।

ডুপ্লিকেট সিম্বল ত্রুটি — ঘটে যখন একটি লাইব্রেরি দুইবার অন্তর্ভুক্ত করা হয় বা pods-এর মধ্যে সিম্বল দ্বন্দ্ব থাকে। সমাধান: ডুপ্লিকেটের জন্য Podfile পরীক্ষা করুন, সিম্বল আলাদা করতে use_frameworks! :linkage => :static ব্যবহার করুন। যদি সমস্যা লাইব্রেরিতে হয়, লেখককে রিপোর্ট করুন। কখনও কখনও Derived Data পরিষ্কার করা এবং Xcode পুনরায় চালু করা সাহায্য করে।

Apple Silicon Mac-এ CocoaPods ইনস্টল হয় না — macOS-এ প্রি-ইনস্টল Ruby Rosetta 2-এর মাধ্যমে চলে, যা কম্পাইলেশন ত্রুটি সৃষ্টি করে। সমাধান: নেটিভ ARM64 আর্কিটেকচারের জন্য rbenv বা asdf-এর মাধ্যমে Ruby ইনস্টল করুন। বিকল্প: Homebrew ব্যবহার করুন — brew install cocoapods স্বয়ংক্রিয়ভাবে ARM64-এর জন্য বিল্ড করে। যদি gems x86_64-এর জন্য ইনস্টল করা থাকে, কমান্ড arch -arm64 sudo gem install cocoapods সমস্যা সমাধান করে।

ধীর pod ইনস্টলেশন — বড় প্রজেক্টে, pod install মিনিট সময় নিতে পারে। সমাধান: ডায়াগনস্টিক্সের জন্য --verbose সক্রিয় করুন। যদি Specs ইতিমধ্যে আপডেট থাকে তবে --no-repo-update ব্যবহার করুন। CI সার্ভারের জন্য, Pods/ ফোল্ডার এবং ~/.cocoapods ক্যাশ করুন। CocoaPods 1.12+-এ, install! 'cocoapods', :parallel_download => true-এর মাধ্যমে সমান্তরাল ডাউনলোড উপলব্ধ।