Update build info for Linux (and fix an obsolete script line).

Author: jonsimantov

AGENTS.md

@@ -66,6 +66,11 @@ The SDK uses CMake for C++ compilation and Gradle for Android-specific parts.
     (replace `firebase_analytics` with the desired library).
     Or omit the entire `--target` parameter to build all targets.
 
+    For development, building specific targets
+    (e.g., `cmake --build . --target firebase_app`) is generally faster and
+    recommended once CMake configuration is complete. The full build
+    (`cmake --build .`) can be very time-consuming.
+
 You can also use the `scripts/gha/build_desktop.py` script to build the full
 desktop SDK.
 
@@ -88,17 +93,21 @@ generated in each library's build directory (e.g.,
 You can build the entire SDK for Android by running `./gradlew build` or
 `build_scripts/android/build.sh`.
 
-### Desktop Platform Setup Details
+#### Troubleshooting Desktop Builds
 
-When setting up for desktop, if you are using an iOS
-`GoogleService-Info.plist` file, convert it to the required
-`google-services-desktop.json` using the script:
-`python generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist`
-(run this from the script's directory, ensuring the plist file is accessible).
+*   Linux: **Missing `libsecret-1-dev`**:
+    CMake configuration may fail if `libsecret-1-dev` is not installed.
+    The `scripts/gha/install_prereqs_desktop.py` script should handle this.
+    If it doesn't, or if the package is removed, you might need to install it
+    manually: `sudo apt-get update && sudo apt-get install -y libsecret-1-dev`.
 
-The desktop SDK searches for configuration files in the current working
-directory, first for `google-services-desktop.json`, then for
-`google-services.json`.
+*   Linux: **LevelDB Patch Failure when building Firestore**:
+    If you are building the SDK with Firestore enabled
+    (`-DFIREBASE_INCLUDE_FIRESTORE=ON`, which is the default for desktop) and
+    encounter a patch error related to `leveldb-1.23_windows_paths.patch` (e.g.,
+    `util/env_windows.cc: patch does not apply`), you can ignore this issue if
+    it does not prevent the rest of the build from running. The patch is only
+    important on Windows.
 
 Common system library dependencies for desktop:
 *   **Windows**: Common dependencies include `advapi32.lib`, `ws2_32.lib`,
@@ -109,6 +118,9 @@ Common system library dependencies for desktop:
 *   **Linux**: Common dependencies include `pthread` (system library). When
     using GCC 5+, define `-D_GLIBCXX_USE_CXX11_ABI=0`.
 
+On all desktop platforms, building with -DFIREBASE_USE_BORINGSSL=YES can help
+bypass any OpenSSL dependency issues.
+
 ## Including the SDK in Projects
 
 ### CMake Projects
@@ -151,18 +163,10 @@ coverage within the integration tests.
     (e.g., Firestore, Auth) are typically located in the `integration_test/`
     directory within that product's module (e.g.,
     `firestore/integration_test/`).
-*   **Test Scripts**: The root of the repository contains scripts for running
-    tests on various platforms, such as:
-    *   `test_windows_x32.bat`
-    *   `test_windows_x64.bat`
-    *   `test_linux.sh`
-    *   `test_mac_x64.sh`
-    *   `test_mac_ios.sh`
-    *   `test_mac_ios_simulator.sh`
-
-    These scripts typically build the SDKs and then execute the relevant tests
-    (primarily integration tests) via CTest or other platform-specific test
-    runners.
+
+    Because building integration tests requires internal google-services files,
+    Jules cannot do it in its environment; instead, we rely on GitHub Actions's
+    Integration Test workflow to build and run the integration tests.
 
 ## Writing Tests
 

scripts/gha/utils.py

@@ -19,7 +19,7 @@
 platforms.
 """
 
-import distutils.spawn
+import shutil
 import glob
 import platform
 import shutil
@@ -63,7 +63,7 @@ def run_command(cmd, capture_output=False, cwd=None, check=False, as_root=False,
 
 def is_command_installed(tool):
   """Check if a command is installed on the system."""
-  return distutils.spawn.find_executable(tool)
+  return shutil.which(tool)
 
 
 def glob_exists(glob_path):