import org.gradle.test.precondition.Requires
import org.gradle.test.preconditions.IntegTestPreconditions
import spock.lang.Issue

import static org.gradle.nativeplatform.fixtures.ToolChainRequirement.VISUALCPP
import static org.gradle.nativeplatform.fixtures.ToolChainRequirement.WINDOWS_GCC
import static org.junit.Assume.assumeFalse

include::{snippetsPath}/native-binaries/cpp-lib/groovy/build.gradle[tag=args]
----


[[native_binaries:windows-resources]]
== Windows Resources

When using the link:{groovyDslPath}/org.gradle.nativeplatform.toolchain.VisualCpp.html[VisualCpp] tool chain, Gradle is able to compile Window Resource (`rc`) files and link them into a native binary. This functionality is provided by the `'windows-resources'` plugin.

=== Example: The 'windows-resources' plugin

                            ${app.sourceType}.preCompiledHeader "${path}${pch}"
                        }
                        binaries.all {
                            if (toolChain.name == "visualCpp") {
                                ${app.compilerArgs("/showIncludes")}
                            } else {
                                ${app.compilerArgs("-H")}
                            }

        result.assertTasksExecuted(tasks.debug.allToLink, ":assemble")

        file("build/object-files").assertIsDir()
        file("build/shared/main.bin").assertIsFile()
        if (toolChain.visualCpp) {
            file("build/import/main.lib").assertIsFile()
        }
    }

    @ToBeFixedForConfigurationCache
    def "library can define public and implementation headers"() {
        given:

        and:
        run installApp

        then:
        result.assertTasksExecuted(libraryDebug.allToLink, appDebug.allToInstall)
        if (toolChain.visualCpp) {
            // App link may or may not be required
            skipped appDebug.compile
            executed libraryDebug.compile, libraryDebug.link
            executed appDebug.install
        } else {

        file("lib2/build/shared/lib1_debug.dll").assertIsFile()
        if (toolChain.visualCpp) {
            file("lib2/build/import/lib1_import.lib").assertIsFile()
        }
        installation("app/build/install/main/debug").exec().out == app.expectedOutput

            </tr>
            <tr>
                <td>org.gradle.nativeplatform.toolchain.Clang</td>
            </tr>
            <tr>
                <td>org.gradle.nativeplatform.toolchain.VisualCpp</td>
            </tr>
            <tr>
                <td>org.gradle.nativeplatform.toolchain.Swiftc</td>
            </tr>
        </table>
    </section>

    <section condition="noNavBar">

+
You can bypass the toolchain discovery by specifying the installation directory of the version of Visual Studio you want via link:{groovyDslPath}/org.gradle.nativeplatform.toolchain.VisualCpp.html#org.gradle.nativeplatform.toolchain.VisualCpp:installDir[VisualCpp.setInstallDir(Object)].

Method <org.gradle.nativeplatform.toolchain.VisualCpp.getInstallDir()> does not have raw return type assignable to org.gradle.api.provider.Property in (VisualCpp.java:0)
Method <org.gradle.nativeplatform.toolchain.VisualCpp.getWindowsSdkDir()> does not have raw return type assignable to org.gradle.api.provider.Property in (VisualCpp.java:0)

Class <org.gradle.nativeplatform.toolchain.internal.msvcpp.VisualCpp> is not annotated (directly or via its package) with @org.gradle.api.NonNullApi in (VisualCpp.java:0)