几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK

简介: 几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK



Flutter 诊断常见问题

问题1:

问题描述

[X] Android toolchain - develop for Android devices
    X Unable to locate Android SDK.
      Install Android Studio from: https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK components.
      (or visit https://flutter.dev/docs/get-started/install/windows#android-setup for detailed instructions).
      If the Android SDK has been installed to a custom location, please use
      `flutter config --android-sdk` to update to that location.

原因分析

这个错误表示找不到Android SDK。可能的原因是Android Studio没有安装或者安装路径没有正确配置。

解决办法

PS > flutter config --android-sdk D:\Android\SDK
Setting "android-sdk" value to "D:\Android\SDK".
You may need to restart any open editors for them to read new settings.

问题2:

问题描述

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    ✗ cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    ✗ Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/docs/get-started/install/windows#android-setup for more details.

原因与解决

这个错误信息表明 Flutter 环境缺少必要的Android工具链和SDK许可证。以下是针对每个错误的解决。

1. 错误信息:cmdline-tools组件缺失
✗ cmdline-tools component is missing
  Run `path/to/sdkmanager --install "cmdline-tools;latest"`

解决方法:

  • 打开终端并运行上述命令,将path/to/sdkmanager替换为你的Android SDK的路径。这个命令会安装最新的cmdline-tools组件。示例:
/path/to/android/sdk/tools/bin/sdkmanager --install "cmdline-tools;latest"
  • 如果你不知道Android SDK的确切路径,可以使用flutter config命令来查找它。运行以下命令:
flutter config --android-sdk
  • 例如:
flutter config --android-sdk D:\Android\android-sdk
2. 错误信息:Android许可证状态未知
✗ Android license status unknown.
  Run `flutter doctor --android-licenses` to accept the SDK licenses.

解决方法:

  • 运行以下命令以接受Android SDK的许可证:
flutter doctor --android-licenses
  • 在运行此命令时,你可能会被要求确认或接受许多许可证,例如:
Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
7 of 7 SDK package licenses not accepted. 100% Computing updates...
Review licenses that have not been accepted (y/N)? Y

请输入y来接受它们,然后回车确定。

完成上述步骤后,你的Flutter环境应该能够正常运行,并且不再显示这些错误信息。如果你遇到其他问题,请检查Flutter和Android SDK的安装,并确保它们都正确配置。

问题3:

问题描述
[!] Network resources
    ✗ An HTTP error occurred while checking "https://github.com/": 信号灯超时时间已到

这个错误信息表明在尝试检查GitHub上的资源时发生了HTTP错误,并且错误信息中提到"信号灯超时时间已到"。这通常是由于网络问题或GitHub服务器不可访问引起的。以下是一些可能的解决方法:

  • 检查网络连接
  • 确保你的计算机能够访问互联网。打开浏览器并尝试访问其他网站,以确保你的网络连接正常。
  • 如果你使用代理服务器或VPN,请确保它们配置正确,并且没有阻止对GitHub的访问。
  • 尝试使用代理
  • 如果你在一个有网络限制的环境中工作(这个需要你自己体会一下,各大博客平台不允许展开讲解),可能需要配置代理服务器。在终端中设置代理服务器,以便你的Flutter环境可以访问GitHub。代理配置方法取决于你的网络环境和操作系统。
  • 检查GitHub状态
  • 有时,GitHub本身可能会遇到问题或维护。你可以访问 GitHub Status 来检查GitHub的当前状态。如果GitHub正在维护或遇到问题,你可能需要等待一段时间,然后再次尝试。
  • 更改仓库源
  • 如果你使用了自定义的Flutter镜像源或软件包管理器源,尝试切换回默认源或更改为可靠的源,以确保能够正常访问GitHub。
  • 检查防火墙和安全软件
  • 一些防火墙或安全软件可能会阻止你的计算机访问特定网站或资源。确保没有安全软件或防火墙规则阻止了对GitHub的访问。

问题3

问题描述
[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    ✗ cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    ✗ Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/docs/get-started/install/macos#android-setup for
      more details.
原因分析

Android toolchain:你的Android SDK缺少cmdline-tools组件。你可以通过运行path/to/sdkmanager --install "cmdline-tools;latest"来安装它,其中path/to/sdkmanager应该替换为你的sdkmanager工具的实际路径。此外,你的Android许可证状态未知,你需要运行flutter doctor --android-licenses来接受SDK许可证。

解决办法
  • 安装cmdline-tools:首先,你需要找到sdkmanager的路径。如果你不确定,可以尝试在终端中运行which sdkmanager。然后,运行以下命令来安装cmdline-tools:
path/to/sdkmanager --install "cmdline-tools;latest"

其中 path/to/sdkmanager 应该替换为你的sdkmanager工具的实际路径。

  • 接受Android许可证:在终端中运行以下命令:
flutter doctor --android-licenses

然后按照提示接受所有许可证即可。

注意事项

如果你没有安装Java运行时,则需要先安装之。可以访问:https://www.oracle.com/java/technologies/downloads/#java21下载一个适合你设备和系统的运行时,或者也可以安装一个Java集成开发环境。

问题4

问题描述
[!] Xcode - develop for iOS and macOS (Xcode 15.0.1)
    ✗ CocoaPods not installed.
        CocoaPods is used to retrieve the iOS and macOS platform side's plugin
        code that responds to your plugin usage on the Dart side.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/platform-plugins
      To install see
      https://guides.cocoapods.org/using/getting-started.html#installation for
      instructions.
原因分析

这个问题当然是在明显经常卡顿但是在果粉那里还不能说的mac系统上才有。原因是Xcode需要CocoaPods,但是你没有安装CocoaPods,它是一个Ruby写的用于检索iOS和macOS平台端的插件代码。没有CocoaPods,插件将无法在iOS或macOS上工作。你可以访问CocoaPods安装指南来安装它。

解决办法

安装CocoaPods:在终端中运行以下命令:

sudo gem install cocoapods

输入你的 Mac 的密码后,CocoaPods 应该会开始安装。安装完成后,你可以通过运行 pod --version 来确认 CocoaPods 是否已经成功安装。

注:

你也可以自己参考 https://guides.cocoapods.org/using/getting-started.html#installation 文档中的描述来完成 cocoapods 的安装

完成以上步骤后,你可以再次运行flutter doctor来检查是否已经解决了所有问题。

注意事项

还有一个是确保你安装了rbenv,你可以按照以下步骤来安装rbenv,并使用它来管理你的Ruby环境:

  1. 安装rbenv。你可以使用以下命令来在你的系统中安装rbenv:
    git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
  2. 安装ruby-build。ruby-build是一个rbenv插件,用于安装不同版本的Ruby。你可以使用以下命令来安装ruby-build:
rbenv install 2.7.4
  1. 安装所需的Ruby版本。使用rbenv,你可以通过以下命令来安装新的Ruby版本:
rbenv install 2.7.4
  1. 设置全局或本地的Ruby版本。使用rbenv,你可以通过以下命令来设置全局或本地的Ruby版本:
rbenv global 2.7.4
  1. 确认Ruby版本。使用以下命令来确认你的Ruby版本是否已经升级:
ruby -v

如果你的系统中仍然在使用旧的Ruby版本,而不是新安装的,你可以尝试使用以下命令来重新加载你的环境变量,并确认你的Ruby版本是否已经切换:

source ~/.zshrc
ruby -v

通过这些步骤,你可以成功安装并使用rbenv来管理你的Ruby环境,并升级到所需的Ruby版本。如果确认你的Ruby版本已经切换到新的版本,那么你可以尝试重新安装cocoapods:

sudo gem install cocoapods
目录
相关文章
|
6月前
|
API 开发工具 Android开发
解决 Android App 上架 Google play后 ,签名变更,第三方sdk无法登录
解决 Android App 上架 Google play后 ,签名变更,第三方sdk无法登录
146 0
|
1天前
|
JavaScript Java Maven
云效产品使用常见问题之android sdk 构建出aar后,上传到私有maven仓库失败如何解决
云效作为一款全面覆盖研发全生命周期管理的云端效能平台,致力于帮助企业实现高效协同、敏捷研发和持续交付。本合集收集整理了用户在使用云效过程中遇到的常见问题,问题涉及项目创建与管理、需求规划与迭代、代码托管与版本控制、自动化测试、持续集成与发布等方面。
|
2月前
|
Dart Shell 开发工具
解决windows安装Flutter时出现Unknown operating system. Cannot install Dart SDK.问题
解决windows安装Flutter时出现Unknown operating system. Cannot install Dart SDK.问题
|
3月前
|
开发工具 Android开发
Android获取SDK的版本信息
Android获取SDK的版本信息
39 0
|
4月前
|
网络协议 Android开发 虚拟化
Android Studio无法运行程序调试程序出现Unable to connect to ADB.Check the Event Log for possible issues.Verify th
Android Studio无法运行程序调试程序出现Unable to connect to ADB.Check the Event Log for possible issues.Verify th
59 0
Android Studio无法运行程序调试程序出现Unable to connect to ADB.Check the Event Log for possible issues.Verify th
|
4月前
|
编解码 Java 开发工具
Android端接入视频生产 Java SDK
Android端接入视频生产 Java SDK
40 1
|
8月前
|
Java 开发工具 Android开发
逻辑清晰,详解社交源码Android开发SDK
前篇我们讲解了有关如何在IOS平台开发集成SDK,那么今天来给大家简单讲解下如何在社交源码Android客户端上开发集成 SDK。
逻辑清晰,详解社交源码Android开发SDK
|
8月前
|
Java 开发工具 Android开发
Android Studio (Android SDK) 配置与使用
Android Studio (Android SDK) 配置与使用
1024 0
|
9月前
|
API 开发工具 Android开发
Android(二) 基于 eclipse 的 Android配置 安装SDK ADT
Android(二) 基于 eclipse 的 Android配置 安装SDK ADT
266 0
|
9月前
|
算法 开发工具 Android开发
Android Proguard不混淆所有SDK(忽略配置设置)
Android Proguard不混淆所有SDK(忽略配置设置)
209 0