将iOS项目进行子工程化

将iOS项目进行子工程化

    在iOS项目开发中，随着项目的愈来愈大，工程的结构化会变差，编译的速度也会愈来愈慢。使用静态库或动态库的方式来构建子工程不只能够加快项目的编译速度，从结构上，也优化了项目的组织。有两种方式来来对项目进行子工程化，能够在项目中建立子项目，也能够建立并列的项目，创建项目依赖。须要注意，不管哪一种方式，你都应该尽可能保证子工程不要用到主工程中的内容，若是必须这样作，你能够采用代理或其余回调编程方式来转交给主工程本身处理。

1、建立子工程的一个示例

    使用Xcode新建一个命名为ProjectDemo的工程，在ProjectDemo工程中再次新建一个framework库工程，点击新建文件中的Project...选项，选择其中的Cocoa Touch Framework工程(建立Cocoa Touch Static Library则会打包为静态库)。

将新建立的工程命名为LoginLib，用来模拟项目中的登陆模块。须要注意，新建工程时，须要将其加入ProjectDemo组，以下图：

对于建立的LoginLib工程，你能够建立一个LoginLib.h头文件用来公开外界须要使用到的类，便于演示，我在里面建立一个视图控制器和一个类别工具类，结构以下：

配置LoginLib的头文件选项，将外界须要用到的进行公开，以下：

如今，分别编译LoginLib工程和ProjectDemo工程，都没有问题，可是你依然没法在ProjectDemo工程中使用LoginLib库中的内容，你须要创建主子工程的关联，在ProjectDemo工程中创建依赖工程并接入动态库，以下所示：

配置Target Dependencies的做用是确保每次主工程编译前都会先对所依赖的工程进行编译。以后，在ProjectDemo工程中导入LoginLib相关头文件便可使用其中功能。

注意，若是报错找不到头文件，你须要设置一下头文件的寻找路径，在ProjectDemo的Build Setting中搜索header，以下图

设置Header Search Paths以下便可。

2、建立依赖模块工程的一个示例

    开发中还有一种场景，公司可能有一组App，这些App中可能有不少类似的模块，例如某些应用程序分为用户端和老板端，他们都有相同的登陆模块，咱们可使用workspace来进行项目和模块的管理。新建一个文件夹命名为Projects，在其中建立一个workspace文件，也命名为Projects。在workspace文件中新建两个项目工程和一个动态库工程，在建立时，注意选择加入workspace，以下图：

建立的3个工程分别命名为UserProject，BossProject和LoginLib，结构以下：

相似咱们的第一个示例，配置完头文件路径后，将动态库引入UserProject和BossProject工程，即实现了LoginLib模块的复用。

3、若是子工程只可以有资源文件

    若是子工程中有资源文件，不管是plist文件仍是图片素材，在主工程调用动态库时，这些文件都是没有被打包进来的。有两种方式来处理这个问题：

1.将资源文件打包成Bundle包，从包中取资源

    Xcode能够建立Bundle资源包，这种文件建立后编译时会自动打包成Bundle文件。须要注意，Xcode只能建立MacOS下的Bundle模板，建立后须要将编译选项设置为iOS。这种方式有很大的弊端，首先主工程必须引入编译后的Bundle包，若是每次新增或修改资源，都要从新打包和导入。其次，在子工程中对素材进行使用时，都必须以Bundle为媒介，增长的复杂度。

2.使用shell拷贝资源脚本

    这种方式每次在编译时都会将资源进行拷贝，相似CocoaPods的管理模式，推荐使用。例如，在主工程的编译选项中新建一个脚本文件，如图：

编写以下脚本代码便可：

#!/bin/sh
# set -e

mkdir -p "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"

install_resource()
{
  if [[ "$1" = /* ]] ; then
    RESOURCE_PATH="$1"
  fi
  if [[ ! -e "$RESOURCE_PATH" ]] ; then
    cat << EOM
error: Resource "$RESOURCE_PATH" not found.
EOM
    exit 1
  fi
  case $RESOURCE_PATH in
    *.storyboard)
      echo "ibtool --reference-external-strings-file --errors --warnings --notices --minimum-deployment-target ${!DEPLOYMENT_TARGET_SETTING_NAME} --output-format human-readable-text --compile ${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename \"$RESOURCE_PATH\" .storyboard`.storyboardc $RESOURCE_PATH --sdk ${SDKROOT} ${TARGET_DEVICE_ARGS}"
      ibtool --reference-external-strings-file --errors --warnings --notices --minimum-deployment-target ${!DEPLOYMENT_TARGET_SETTING_NAME} --output-format human-readable-text --compile "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename \"$RESOURCE_PATH\" .storyboard`.storyboardc" "$RESOURCE_PATH" --sdk "${SDKROOT}" ${TARGET_DEVICE_ARGS}
      ;;
    *.xib)
      echo "ibtool --reference-external-strings-file --errors --warnings --notices --minimum-deployment-target ${!DEPLOYMENT_TARGET_SETTING_NAME} --output-format human-readable-text --compile ${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename \"$RESOURCE_PATH\" .xib`.nib $RESOURCE_PATH --sdk ${SDKROOT} ${TARGET_DEVICE_ARGS}"
      ibtool --reference-external-strings-file --errors --warnings --notices --minimum-deployment-target ${!DEPLOYMENT_TARGET_SETTING_NAME} --output-format human-readable-text --compile "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename \"$RESOURCE_PATH\" .xib`.nib" "$RESOURCE_PATH" --sdk "${SDKROOT}" ${TARGET_DEVICE_ARGS}
      ;;
    *.framework)
      echo "mkdir -p ${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
      mkdir -p "${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
      echo "rsync -av $RESOURCE_PATH ${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
      rsync -av "$RESOURCE_PATH" "${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
      ;;
    *.xcdatamodel)
      echo "xcrun momc \"$RESOURCE_PATH\" \"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH"`.mom\""
      xcrun momc "$RESOURCE_PATH" "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH" .xcdatamodel`.mom"
      ;;
    *.xcdatamodeld)
      echo "xcrun momc \"$RESOURCE_PATH\" \"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH" .xcdatamodeld`.momd\""
      xcrun momc "$RESOURCE_PATH" "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH" .xcdatamodeld`.momd"
      ;;
    *.xcmappingmodel)
      echo "xcrun mapc \"$RESOURCE_PATH\" \"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH" .xcmappingmodel`.cdm\""
      xcrun mapc "$RESOURCE_PATH" "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/`basename "$RESOURCE_PATH" .xcmappingmodel`.cdm"
      ;;
    *.xcassets)
	  echo "all xcassets will compile later!"
      ;;
    *)
      echo "$RESOURCE_PATH"
      echo "$RESOURCE_PATH" >> "$RESOURCES_TO_COPY"
      ;;
  esac
}

install_project_resouces()
{
  PROJECT_RESOURCE_DIR="${PROJECT_DIR}/../$1"
  
  if [[ ! -e "${PROJECT_RESOURCE_DIR}" ]]; then
    cat << EOM
error: PROJECT_RESOURCE_DIR "${PROJECT_RESOURCE_DIR}" not found
EOM
    exit 1
  fi

  echo "copy resources in ${PROJECT_RESOURCE_DIR} to ${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"

  ALL_RESOURCES=()

  FIND_ALL_RESOURCES=$(find "$PROJECT_RESOURCE_DIR" -iname "*.xcassets" -o -iname "*.xib" -o -iname "*.storyboard" -o -iname "*.plist" ! -iname "Info.plist")
  while read line; do
      ALL_RESOURCES+=("$line")
  done <<<"$FIND_ALL_RESOURCES"

  RESOURCES_TO_COPY="${PROJECT_RESOURCE_DIR}/resources-to-copy.txt"
  > "$RESOURCES_TO_COPY"

  case "${TARGETED_DEVICE_FAMILY}" in
    1,2)
      TARGET_DEVICE_ARGS="--target-device ipad --target-device iphone"
    ;;
    1)
      TARGET_DEVICE_ARGS="--target-device iphone"
    ;;
    2)
      TARGET_DEVICE_ARGS="--target-device ipad"
    ;;
    3)
      TARGET_DEVICE_ARGS="--target-device tv"
    ;;
    *)
      TARGET_DEVICE_ARGS="--target-device mac"
    ;;
  esac

  for i in ${ALL_RESOURCES[@]}; do
    install_resource "${i}"
  done

  mkdir -p "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
  rsync -avr --copy-links --no-relative --exclude '*/.svn/*' --files-from="$RESOURCES_TO_COPY" / "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
  if [[ "${ACTION}" == "install" ]] && [[ "${SKIP_INSTALL}" == "NO" ]]; then
    mkdir -p "${INSTALL_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
    rsync -avr --copy-links --no-relative --exclude '*/.svn/*' --files-from="$RESOURCES_TO_COPY" / "${INSTALL_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
  fi

  rm -f "$RESOURCES_TO_COPY"
}

for module in ${MODULES}; do
  install_project_resouces "${module}"
done

XCASSETS_SEARCH_DIR="${PROJECT_DIR}/.."
XCASSET_FILES=()

if [[ -n "${WRAPPER_EXTENSION}" ]] && [ "`xcrun --find actool`" ]
then
  # Find all other xcassets (this unfortunately includes those of path pods and other targets).
  ALL_XCASSETS=$(find "$XCASSETS_SEARCH_DIR" -iname "*.xcassets" -type d)
  while read line; do
    if [[ $line != "${PODS_ROOT}*" ]]; then
      XCASSET_FILES+=("$line")
    fi
  done <<<"$ALL_XCASSETS"

  echo "compile all xcassets: ${XCASSET_FILES[@]}"
  printf "%s\0" "${XCASSET_FILES[@]}" | xargs -0 xcrun actool --output-format human-readable-text --notices --warnings --platform "${PLATFORM_NAME}" --minimum-deployment-target "${!DEPLOYMENT_TARGET_SETTING_NAME}" ${TARGET_DEVICE_ARGS} --compress-pngs --compile "${BUILT_PRODUCTS_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"
fi

echo "all done!"

4、一点小体悟

    本博客所讨论的，只是从工程结构上实现模块化与组件化的方式，一个公司可能会有不少个App产品，但其中必定有某些基础模块是能够复用的，除了进行静态库封装或动态库封装外，进行并列工程化也是一种很好的选择，这样能够同步开发，迭代更快。除了公用的模块，还有一些模块可能并不公用可是确能够独立开发，例如资讯类项目中可能会有用户模块，社交模块和内容模块，将这些拆分为项目内的子工程可使项目的结构更加清晰，模块化测试也更容易进行。

    最后，仅仅项目结构上的模块化远远达不到真正实现组件化项目的要求，遵照协议为标准，以函数式编程为方式，全局着眼的接口设计与路由规划，良好的编程习惯与统一的代码风格，这种代码层面的项目开发管理才真正任重道远。后面有时间我会陆续经过其余博客来探讨这些问题。但愿一块儿交流，共同窗习！