Mac 搭建开发环境

一、 iOS 开发环境配置

  • 所需要的依赖有：CocoaPods 和 Xcode (iOS SDK）

1. 安装 Xcode

  • 通过 App Store 或是到 Apple 开发者官网open in new window下载
  • 安装 Xcode 后打开并安装 Apple SDK（完成后这一步骤会同时安装 Xcode IDE、Xcode 的命令行工具和 iOS 模拟器）

2. 安装 CocoaPods

  • 运行下方命令安装 CocoaPods
sudo gem install cocoapods
# 或 brew install cocoapods
  • 运行命令后，稍等片刻即可安装完成
  • 可在开发者工具运行「环境检测」查看到 iOS 开发环境搭建完成。如果按照上述步骤操作后，环境检测无法通过，可查看环境搭建常见问题

二、 Android 开发环境配置

  • 所需要的依赖有：JDK 和 Android SDK 环境

1. 安装 JDK

    1. 前往官网open in new window下载 （当前多端项目模板使用的是 6.7.1 的 gradle 版本，建议使用 JAVA8 <= JAVA 版本 <= JAVA15 的 JAVA 版本）并安装。参考文章open in new window
    1. 配置环境前，可打开终端输入命令 echo $SHELL 判断本地 shell 版本， 从而选择对应的环境变量方式，如下面的 bash 或者 zsh
    1. 执行 open -e ~/.bash_profile， 或者 open -e ~/.zshrc 打开对应的配置文件（如果执行的时候发现文件不存在，可以通过 touch ～/.bash_profile 或 touch ~/.zshrc 新建打开）
    1. 添加 JAVA_HOME 等相关环境变量，例如下载的版本为 11.0.17，则添加下方内容
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.0.17.jdk/Contents/Home
PATH=$JAVA_HOME/bin:$PATH:.
CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.
export JAVA_HOME
export PATH
export CLASSPATH
    1. 执行命令 source ~/.bash_profile 或者 source ~/.zshrc 使配置生效
    1. 验证 JDK 是否安装成功 打开终端，输入java -version和echo $JAVA_HOME，查看效果

注意：如果已经打开开发者工具，需要重启下工具

2. 安装 Android SDK

Android SDK 可以通过两种方式方式进行安装，可任意选择一种进行安装

三、 下载开发者工具

四、环境搭建常见问题

1. xcode version not found

  • 如遇到上方问题，可执行下方命令查看是否可以获取 xcode 的版本
xcodebuild -version
  • 如出现报错：xcode-select: error: tool "xcodebuild requires Xcode, but active developer directory "/Library/Developer/CommandLineTools' is a command line tools instance；则可以运行下方命令将其修复
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

2. 如何查看已安装的 jdk

  • Mac 下安装的 JDK，一般都在 /Library/Java/JavaVirtualMachines 下。进入这个路径可以看到你安装的全部版本 JDK 。

3. Android SDK not found

  • 这可能是因为尚未安装Android SDK Command-line Tools 导致的，按照上面指引安装后，重启微信开发者工具即可

4. ANDROID_HOME not found

  • 这是因为环境变量没有配置好导致的，按照上面指引安装后，重启微信开发者工具即可

5. Android SDK 版本过高

  • 如果出现下方提示，Android SDK 的版本和 supported 的不一致，可以前往「SDK Manager」重新安装一个匹配的版本
  • 说明，不仅要安装 「SDK Platfomrs」还需要安装 「SDK Tools」
  • 此外，开发者也可以通过修改 Android 项目内的 buildToolsVersion 进行调整支持的 sdk 版本

6. Android Studio 安装了但是检测不到

  • 这可能是因为没有安装到 /Applications 下，工具会当前目录下检测 Android Studio.app 是否存在

7. 如何安装不同版本的 Android SDK

  • Android SDK Manager 把 “ Show Package Details ” 打开，并且勾上对应的 SDK 进行安装即可

8. 如何查看 Android SDK 安装路径

  • 关于 Android SDK 默认路径为 $HOME/Library/Android/sdk ，如开发者安装 SDK 时选择自定义路径，可前往下方截图处查看 SDK 实际的路径