知识库/文章阅读
公开访问登录
返回全部文章
技术与开发公开文章

macOS公司开发环境安装配置指南

macOS公司开发环境安装配置指南

18 分钟阅读Markdown
#开发环境#macOS

一、抹掉磁盘并重装系统(可选)

如果是旧电脑需要做开发者隔离，推荐使用抹掉磁盘+重装系统，如果当前电脑之前使用过其他开发者账号后，当然最好是换台新设备，而不是简单的抹掉内容和配置。

重置步骤：

  1. 关机并重启，进入恢复模式（按住 Command + R）
  2. 打开“磁盘工具” > 抹掉整个系统盘（Macintosh HD）
  3. 重新安装 macOS
  4. 开机后以全新设备使用（不恢复任何备份）

按照正常的流程配置激活系统即可。

二、默认安装位置&自定义位置

  • 默认安装位置：/usr/local/
  • Brew默认安装位置：/opt/homebrew/
  • 自定义安装位置：/Users/xiaopin/dev/

有些工具和包通过安装文件的方式安装的，可以自定义目录，但是需要自己配置环境变量，如果是用HomeBrew的，系统自定选择安装的默认位置。因为是考虑到有时候brew安装巨慢的时候，可以考虑手动官网下载安装程序进行安装。

三、基础配置

3.1 从Finder中配置显示Macintosh HD和用户目录

英文：打开Finder，点击顶部菜单Finder->Settings

中文：打开访达，点击顶部菜单访达->设置->边栏->勾选硬盘->勾选用户目录(房子图标)

3.2 科学网络配置

下载安装ClashX，配置订阅节点即可，不详细解释。有科学网络1.2步骤就不需要了。

或其他工具都可以

简易版本：https://clashx.tech/en/download

增强版：https://clashfx.com/

3.3 统一公司项目存储目录

项目统一存放在：桌面 > Projects,

也可以是：

Flutter项目：FlutterProjects

iOS原生项目：SwiftProjects

四、iOS开发环境安装&配置

1.准备好一个AppleID, 登录到AppStore

2.更新macOS最新系统

桌面左上角苹果图标->系统设置->通用->软件更新

3.直接通过AppStore安装Xcode，会将git一起安装

五、HomeBrew安装&配置

Homebrew官网

打开终端命令输入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

或使用国内镜像更快

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

如果失败多试几次，可能是你的网络问题，安装完成以后命令行输入：brew -v ，查看homebrew版本看看是否安装成功。

其他工具的安装

六、Ruby安装&配置

一般情况下，macOS默认会安装ruby，版本可能不是最新的

官方网站：https://www.ruby-lang.org/zh_cn/downloads/

  • 使用Brew安装最新的Ruby版本
brew install ruby
  • 修改Shell配置文件,
#Intel芯片(目前来说可以抛弃了，现在基本都是苹果芯片)
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
#苹果M系列芯片
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

也可以手动的的找到.zshrc文件，一般在 Users/用户名/.zshrc 目录下，用文本编辑器打开，在最后面加上

#在后面加上这行，会自动的将默认环境指向homebrew的ruby版本
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
  • 验证安装
#查看默认ruby路径
which ruby
#查看ruby版本
ruby -v

七、Cocoapods安装&配置

Gems 是 Ruby 的包管理系统（RubyGems）用来分发和管理 Ruby 库和应用程序的包。Gems 可以包含库、应用程序、文档和其他资源，方便开发者在项目中使用和管理依赖。

官网：https://rubygems.org

  1. 升级gem命令
sudo gem update --system
  1. 更换镜像源

移除旧源

gem sources --remove https://rubygems.org/

添加新源

gem sources -a https://gems.ruby-china.com

查看镜像源信息

gem sources -l
  • 彻底卸载cocoapods
  1. 卸载已有旧版本
sudo gem uninstall cocoapods
  1. 查看本地已安装的cocoapods依赖
gem list --local | grep cocoapods

显示如下:

cocoapods (1.0.1)

cocoapods-core (1.0.1)

cocoapods-deintegrate (1.0.1)

cocoapods-downloader (1.1.1)

cocoapods-plugins (1.0.0)

cocoapods-search (1.0.0)

cocoapods-stats (1.0.0)

cocoapods-trunk (1.0.0)

cocoapods-try (1.1.0)

  1. 逐个删除
sudo gem uninstall cocoapods-core
sudo gem uninstall cocoapods-deintegrate
sudo gem uninstall cocoapods-downloader
sudo gem uninstall cocoapods-plugins
sudo gem uninstall cocoapods-search
...
  • Cocoapods安装

macOS 10.11以后系统的安装cocoapods 指令，可安装制定版本：

sudo gem install -n /usr/local/bin cocoapods
或
sudo gem install -n /usr/local/bin cocoapods -v 1.16.2

安装完成后，查看一下版本

pod --version

八、Android开发环境安装&配置

1 资源文档地址

Android官网：https://www.android.com/intl/zh-CN_cn/

Android开发者中心：https://developer.android.com/?hl=zh-cn

2 JDK安装配置

OpenJDK: https://adoptium.net/zh-cn/

OpenJDK推荐统一下载 17LTS版本，以后如果环境需要再升级到21LTS

直接双击*.pkg安装文件安装

3 Android Studio安装配置

Android Studio 是开发 Android 应用的官方 IDE，包含了 Android SDK、模拟器等开发所需的工具。

  1. 下载并安装 Android Studio：

    • 访问 Android Studio 官方网站：https://developer.android.com/studio，推荐安装与 Flutter 适配的版本，详见【Android 开发环境搭建入门到精通.md】。

    • 下载适用于 macOS 的安装包，并进行安装。

  2. 打开 Android Studio，按照向导完成安装过程。

    • 安装过程中会提示安装 Android SDK、Android Virtual Device (AVD) 和其他依赖工具，点击 Next 完成安装。

  3. 设置 Android SDK：

    • 启动 Android Studio 后，打开 Preferences（在顶部菜单栏点击 Android Studio > Preferences）。

    • 在 SDK Manager 中，确保 Android SDK 和 Android SDK Build-Tools 已安装，并选择需要的 Android API 版本。

  4. 设置JDK路径(可选)

    Android Studio > Settings > Build，Execution,Deployment > Build Tools > Gradle > Gradle Projects > Gradle JDK > 选择默认的或者自己安装的JDK环境

4 配置模拟器

配置步骤：Android Studio > Tools > Device Manager > 添加

根据提示安装对应的模拟器

5 创建项目并运行

新建一个模版工程-> 等待配置安装依赖完成 -> 选择模拟器 -> 运行或调试

6 更多详细

更多更详细的细节查看【Android 开发环境搭建入门到精通.md】

九、Flutter安装&配置

使用FVM方式下载安装多个版本管理

1.介绍说明

FVM (Flutter Version Management) 是一个开源工具，旨在简化和管理 Flutter 的不同版本，允许开发者在一个项目中使用特定版本的 Flutter，而无需更改全局安装的 Flutter 版本。

官方网站：https://fvm.app/documentation/getting-started

多版本管理：

• 支持在不同项目中使用不同的 Flutter 版本。

• 允许轻松切换 Flutter 版本，而无需手动安装或卸载。

项目级版本控制：

• 每个项目可以指定一个特定的 Flutter 版本，其他项目不会受到影响。

• 避免因 Flutter 版本更新而导致的兼容性问题。

共享版本：

• 同一设备上多个项目可以共享相同的 Flutter 版本，减少磁盘空间浪费。

易于 CI/CD 集成：

• 提供简单的工具和命令行支持，适合在 CI/CD 管道中指定 Flutter 版本。

FVM 是管理 Flutter 多版本的强大工具，适用于团队协作和复杂项目场景，能显著提升开发效率，避免版本兼容性问题。如果你的项目需要频繁切换 Flutter 版本，或者团队中有多个项目运行在不同的版本上，FVM 是一个值得采用的工具。

2.安装和使用

2.1Homebrew安装FVM
#安装命令
brew tap leoafarias/fvm
brew install fvm

#卸载命令
brew uninstall fvm
brew untap leoafarias/fvm
查看版本
fvm --version
2.2.配置环境变量
# 设置 FVM 缓存路径  
export FVM_CACHE_PATH="$HOME/fvm_cache"  
# 启用 Git 缓存  
export FVM_USE_GIT_CACHE=true  
# 设置 Git 缓存路径  
export FVM_GIT_CACHE_PATH="$HOME/fvm_git_cache"  
# 自定义 Flutter 仓库地址  
export FVM_FLUTTER_URL="https://github.com/flutter/flutter.git"  
# 启用特权访问  
export FVM_PRIVILEGED_ACCESS=true

FVM_GIT_CACHE_PATH

•用于存储 Flutter Git 仓库的本地引用。

•主要作用是加速 Flutter SDK 的版本切换和下载过程。

•默认路径：~/.fvm/git_cache/。

FVM_CACHE_PATH

•用于存储已下载的 Flutter SDK 文件（即解压后的完整 Flutter SDK）。

•这是实际使用 Flutter SDK 的路径。

•默认路径：~/.fvm/versions/。

将这两个存放到自己指定的目录中，比如我的开发环境一般都存放在/User/xiaopin/dev/ 中, 只要配置这两个就好了。

# FVM存储路径配置
export FVM_GIT_CACHE_PATH="/Users/xiaopin/flutter/fvm/gitcache/"
export FVM_CACHE_PATH="/Users/xiaopin/flutter/fvm/"

export PATH=/Users/xiaopin/flutter/fvm/default/bin:$PATH
export PATH="$PATH":"$HOME/.pub-cache/bin"
2.3.安装指定版本flutter
fvm install 3.24.0
2.4.在项目中指定Flutter版本

在项目根目录下，使用以下命令将特定的 Flutter 版本关联到该项目：

fvm use 3.24.0

这会生成一个 .fvm 文件夹和一个 fvm_config.json 文件，用于保存项目的 Flutter 版本配置。

2.5.运行Flutter命令
fvm flutter run
fvm flutter doctor
2.6.升级Flutter版本
fvm install <new_version>
fvm use <new_version>
2.7.卸载旧Flutter版本
fvm remove 3.24.0
2.8. 查看已安装版本
fvm list

3.10.0 (global)
3.13.0 (active)
2.5.3

• global：全局版本，默认在所有项目中使用。

• active：当前项目的版本。

2.9. 查看可安装版本
fvm releases

stable
3.13.1
3.13.0
...
beta
3.14.0-1.0.pre
3.13.0-0.3.pre
...
2.10. 清理FVM所有缓存和SDK

FVM中的destroy命令是一个强大的工具，用于完全删除FVM缓存，包括所有缓存的Flutter SDK版本。此命令对于清理空间或重置FVM设置很有用。

fvm destroy

3. 设置默认全局Flutter版本

fvm global 3.24.5

4. 项目单独指定Flutter版本

fvm use 3.24.0

5. FVM 配置文件

在项目中，FVM 会生成两个关键文件：

  • .fvm/fvm_config.json：
{
  "flutterSdkVersion": "3.13.0"
}
  • .gitignore

通常会忽略 .fvm/ 文件夹以避免版本冲突。

6. FVM 的适用场景

1.团队协作：

​ 确保团队成员使用相同的 Flutter 版本，避免因版本差异引发问题。

  1. 维护旧项目：

​ 在新项目中使用最新版本的 Flutter，同时为旧项目保留其兼容的版本。

  1. 测试与调试：

​ 快速切换 Flutter 版本以测试兼容性或复现问题。

更多详细

更多详细的查阅【001-Flutter必备基础和环境安装.md】

十、代码管理工具

安装Github Desktop桌面版，登录Github账号即可。避免各种复杂配置。

— 感谢阅读 —继续探索知识库