Guides

Troubleshooting

CocoaPods Failed to Download ComPDF (SSL Network Request Failure)

When executing pod install on iOS, if the download of ComPDFKit / ComPDFKit_Tools fails due to SSL network request failures, you can troubleshoot and use alternatives as follows.

Method A: Refresh CocoaPods Cache and Retry (Recommended First)

Execute in the example/ios directory:

pod repo update
pod cache clean --all
rm -rf Pods Podfile.lock
pod install --repo-update

Method B: Switch Podspec Download Source to GitHub (Alternative Solution)

If Method A still fails, you can switch from the original podspec:'https://file.compdf.com/... to the GitHub source in ios/Podfile:

Note: Replace 2.6.0 with the tag that matches your current ComPDF iOS SDK version (it's recommended to keep it consistent with the Podspec version mentioned earlier in this guide).

target 'Runner' do
  use_frameworks!
  use_modular_headers!

-  pod "ComPDFKit", podspec:'https://file.compdf.com/cocoapods/ios/compdfkit_pdf_sdk/2.6.0/ComPDFKit.podspec'
-  pod "ComPDFKit_Tools", podspec:'https://file.compdf.com/cocoapods/ios/compdfkit_pdf_sdk/2.6.0/ComPDFKit_Tools.podspec'
+  pod 'ComPDFKit', :git => 'https://github.com/ComPDFKit/compdfkit-pdf-sdk-ios-swift.git', :tag => '2.6.0'
+  pod 'ComPDFKit_Tools', :git => 'https://github.com/ComPDFKit/compdfkit-pdf-sdk-ios-swift.git', :tag => '2.6.0'

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end