将ARCharts导入Swift iOS项目时遇模块及Core Animation相关错误

Let's break down how to properly integrate ARCharts into your project and resolve the errors you're facing:

Why You're Seeing These Errors #

• The "ARCharts module not found" error popped up because dragging files directly didn't set up the module structure correctly for Xcode to recognize it as a valid module.
• Using the debug framework from the sample project led to Core Animation errors because that framework is built specifically for the sample's environment and doesn't include all required dependencies (like QuartzCore, which houses CABasicAnimation) that the sample project links automatically behind the scenes.

Solution 1: Use CocoaPods (Simplest Approach) #

This is the most reliable way to add ARCharts and handle dependencies automatically:

1. If you don't have a Podfile in your project directory, create one with this command in Terminal:

   pod init
   

2. Open the Podfile and add this line inside your target block:

   pod 'ARCharts'
   

3. Run this command to install the pod:

   pod install
   

4. Open your project using the .xcworkspace file (not the .xcodeproj), add import ARCharts to your ViewController, and your code should work without module or dependency errors.

Solution 2: Manual Source Code Import #

If you prefer not to use CocoaPods, follow these steps to properly add the source code:

1. Download the full ARCharts source code from its repository.
2. Drag the ARCharts folder (the core source folder, not the sample project files) into your iOS project. Make sure to:
   • Check "Copy items if needed"
   • Select your project's target under "Add to targets"
3. Fix Core Animation Dependencies:
   • Go to your project's Build Phases > Link Binary With Libraries
   • Click the "+" button, search for QuartzCore.framework, and add it. This will resolve the "CABasicAnimation undeclared type" errors since Core Animation is part of the QuartzCore framework.
4. Verify Module Setup:
   • Ensure your project's Build Settings have Enable Modules (C and Objective-C) set to Yes (under "Apple Clang - Language Modules").
   • The ARCharts source includes a module.modulemap file, which Xcode will use to recognize it as a module. You can now safely add import ARCharts to your ViewController.

Key Notes to Avoid Future Issues #

• Never use the debug framework from the sample project's build folder—it's tied to that project's specific build configuration and won't work reliably in your own project.
• Always double-check that all required source files are added to your target's Compile Sources list (under Build Phases) to prevent missing symbol errors.

内容的提问来源于stack exchange，提问作者Sam