cu-sdk-setup

Run the setup_user_env.sh script (or setup_user_env.ps1 on Windows) from the package directory. It verifies JDK 8+ and Maven 3.6+, resolves dependencies, and interactively creates a .env file with your Foundry endpoint and model deployments.

Load the .env file into your shell first, then run mvn exec:java with -Dexec.mainClass pointing to the sample class and -Dexec.classpathScope=test. The test classpath scope is required because samples live under src/samples/java.

Yes, you can leave CONTENTUNDERSTANDING_KEY empty and authenticate via DefaultAzureCredential after running az login. You must also assign yourself the Cognitive Services User role on the Foundry resource, even if you own it.

This happens when -Dexec.classpathScope=test is missing from the mvn exec:java command. Sample classes are compiled into the test classpath, so without that flag Maven cannot find them.

The default build enforces a minimum coverage ratio, and skipping tests produces no coverage data, causing the jacoco check goal to fail. Add -Djacoco.skip=true to the command to bypass the coverage check during environment setup.

The SDK requires JDK 8 or later, with JDK 11, 17, or 21 LTS recommended, and Maven 3.6 or later. The setup script probes both versions and offers to install them via Homebrew, apt, or winget if missing.