Troubleshooting
Keep the exact command, CLI revision, compiler version, stdout report, stderr and exit code. Start with a minimal input that reproduces the issue.
The CLI is not available#
This pre-prod uses restricted access. Request a checkout from the owner who provided access; there is no public download link. Follow Installation and keep the binary's resource bundles beside it.
source-scan requires --allow-build#
The flag is an explicit authorization boundary. The command evaluates Package.swift, may retrieve locked Git dependencies and performs an indexed build. Review the input, then provide the flag if you intend those actions.
#
Read reasons. unsupported-resource-census and unsupported-resource-rule identify the tutorial's deliberately unsupported resource input. Reduce the input or use an admitted form; removing a limitation from the JSON does not change admission.
source-count, module-count, authored-generated-source-count, source-file-bytes or source-bytes reasons mean the bounded envelope was exceeded. Select a small supported product. A full scan of this analyzer repository is not currently supported by the documented workflow.
The report says degraded with zero findings#
Check conditions and families. Unknown observations, missing source effects, native effects or families with no observations prevent a clean interpretation. The tutorial control intentionally demonstrates this case. See Understand results.
A build or toolchain step fails#
Verify xcrun swift --version, the selected developer tools, package access and locked dependency state. Do not point the analyzer at a different compiler's Index Store and assume compatibility. Preserve acquisition reasons when asking the owner for help.
An existing Index Store is rejected#
A raw Index Store is not the manifest-backed immutable snapshot required by doctor, stats, scan or why. Ask its supplier for the complete admitted bundle and profile, or use source-scan for a supported product.
Report a documentation mismatch#
Include the page URL, visible product revision, exact command and observed outcome. Share the smallest relevant source example through the project's existing owner contact. Remove unrelated source, credentials and machine-local paths before sharing. No automated source-upload service is part of these docs.