iOS

Requirement

you must have these settings being prepared:

• have XCode installed

once prepared, it's recommended to follow Quick setup for quick setup your project files

Using as Cocoapods

you may also use ZFFramework as Cocoapods for convenient

pod 'ZFFramework'
// or, if you only want specified sub module
// pod 'ZFFramework/ZFCore'

if you want to keep update with the development version, you may clone the development repo to the same dir of your project, and use:

pod 'ZFFramework',:path => '../ZFFramework'

specially, when adding resource files, you must ensure they are placed under YourApp.app/zfres/, see the Manual Setup below for how to do it

Manual Setup

if you really want to setup manually:

1. build necessary libraries of ZFFramework, by one of these methods:
   • tools from ~/tools/release
   • manually build projects under ~/ZF
2. create your own iOS project
3. drag and drop ZFFramework's libraries (*.xcframework) to your project
4. modify your project's target settings:
   • Header Search Paths
   • Library Search Paths
   • Other Linker Flags:
     "-ObjC -all_load"
5. ensure these libraries seleted in "Link Binary With Libraries" of XCode's target settings:
   • Foundation.framework
   • UIKit.framework
   • QuartzCore.framework
   • CoreGraphics.framework
   • WebKit.framework, if you want the ZFUIWebKit module
   • all ZFFramework's *.xcframework files
6. add "New Run Script Phase" in your project's target's "Build Phases", to copy all resource files:

   ZF_ROOT_PATH=${SRCROOT}/path_to_ZFFramework
   RES_DST_PATH=${CONFIGURATION_BUILD_DIR}/${CONTENTS_FOLDER_PATH}/zfres
    
   sh "$ZF_ROOT_PATH/tools/util/copy_res.sh" "$ZF_ROOT_PATH/_release/iOS/module/required_ZF_lib_name/zfres" "$RES_DST_PATH"
   # ...
    
   sh "$ZF_ROOT_PATH/tools/util/copy_res.sh" "${SRCROOT}/../../../zfres" "$RES_DST_PATH"

   or, if you prefer to make it manually, please ensure all resource files of all modules are placed like this: (folder structure must be kept)

   YourApp.app/
       zfres/
           ZFUIKit/
               xxx.xml
           ZFUIWidget/
               xxx.xml

7. create cpp files in your project and follow the Tutorial to code with ZFFramework, enjoy