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):