Add Android specific sub-step to validate the Android sdk path has no spaces (flutter#170829)

The android sdk cannot have spaces in it 

<img width="704" alt="Screenshot 2025-06-18 at 11 41 12 AM"
src="https://github.com/user-attachments/assets/2d78599d-8417-4af6-8bc8-f9037f4aab01"
/>


Add a validation step that it doesn't as it currently blocks building an
app bundle (as we need the apkanalyzer now, after the debug symbol
changes).

## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [x] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [x] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel
on [Discord].

<!-- Links -->
[Contributor Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
[Tree Hygiene]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
[test-exempt]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
[Flutter Style Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
[Features we expect every widget to implement]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
[CLA]: https://cla.developers.google.com/
[flutter/tests]: https://github.com/flutter/tests
[breaking change policy]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
[Discord]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
[Data Driven Fixes]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

---------

Co-authored-by: Gray Mackall <mackall@google.com>

Author: gmackall

packages/flutter_tools/lib/src/android/android_sdk.dart

@@ -239,6 +239,15 @@ class AndroidSdk {
       return <String>[msg.toString()];
     }
 
+    if (directory.absolute.path.contains(' ')) {
+      final String androidSdkSpaceWarning =
+          'Android SDK location currently '
+          'contains spaces, which is not supported by the Android SDK as it '
+          'causes problems with NDK tools. Try moving it from '
+          '${directory.absolute.path} to a path without spaces.';
+      return <String>[androidSdkSpaceWarning];
+    }
+
     return latestVersion!.validateSdkWellFormed();
   }
 

packages/flutter_tools/lib/src/android/gradle.dart

@@ -55,7 +55,9 @@ const String _kBuildVariantRegexGroupName = 'variant';
 const String _kBuildVariantTaskName = 'printBuildVariants';
 @visibleForTesting
 const String failedToStripDebugSymbolsErrorMessage = r'''
-Release app bundle failed to strip debug symbols from native libraries. Please run flutter doctor and ensure that the Android toolchain does not report any issues.
+Release app bundle failed to strip debug symbols from native libraries.
+Please run flutter doctor and ensure that the Android toolchain does not
+report any issues.
 
 Otherwise, file an issue at https://github.com/flutter/flutter/issues.''';
 

packages/flutter_tools/test/general.shard/android/android_sdk_test.dart

@@ -315,6 +315,35 @@ void main() {
       },
     );
 
+    testUsingContext(
+      'detects spaces in Android SDK path',
+      () {
+        final Directory sdkDir = createSdkDirectory(
+          fileSystem: fileSystem,
+          directoryName: 'flutter_mock_android_sdk with spaces.',
+        );
+        processManager.addCommand(
+          const FakeCommand(
+            command: <String>[
+              '/.tmp_rand0/flutter_mock_android_sdk with spaces.rand0/cmdline-tools/latest/bin/sdkmanager',
+              '--version',
+            ],
+          ),
+        );
+        config.setValue('android-sdk', sdkDir.path);
+
+        final List<String> validationIssues =
+            AndroidSdk.locateAndroidSdk()!.validateSdkWellFormed();
+        expect(validationIssues.first, contains('Android SDK location currently contains spaces'));
+      },
+      overrides: <Type, Generator>{
+        FileSystem: () => fileSystem,
+        ProcessManager: () => processManager,
+        Config: () => config,
+        Platform: () => FakePlatform(),
+      },
+    );
+
     testUsingContext(
       'does not throw on sdkmanager version check failure',
       () {
@@ -621,9 +650,10 @@ Directory createSdkDirectory({
   required FileSystem fileSystem,
   String buildProp = _buildProp,
   Platform? platform,
+  String directoryName = 'flutter_mock_android_sdk.',
 }) {
   platform ??= globals.platform;
-  final Directory dir = fileSystem.systemTempDirectory.createTempSync('flutter_mock_android_sdk.');
+  final Directory dir = fileSystem.systemTempDirectory.createTempSync(directoryName);
   final String exe = platform.isWindows ? '.exe' : '';
   final String bat = platform.isWindows ? '.bat' : '';