The IDEA plugin also adds an `openIdea` task when the project is the root project. This task generates the IDEA configuration files and opens the result in IDEA. This means you can simply run `./gradlew openIdea` from the root project to generate and open the IDEA project in one convenient step.

    @ToBeFixedForConfigurationCache
    def "generated IDEA metadata respects idea plugin configuration"() {
        given:
        dependency 'org.test:b1:1.0'
        dependency 'org.test:b2:1.0'

        buildB.buildFile << """
            project(':b1') {
                idea.module.name = 'b1-renamed'
            }
"""

        when:
        idea()

        then:

  <scope name="IDE" pattern="file[idea_main]:*/||file[idea]:testData/*/||file[idea-formatter_main]:*/||file[ide-common_main]:*/||file[idea-android_main]:*/||file[idea-android-output-parser_main]:*/||file[idea]:idea-completion/testData/*/||file[idea-core_main]:*/||file[idea-gradle_main]:*/||file[idea-jps-common_main]:*/||file[idea-jvm_main]:*/||file[idea]:idea-live-templates/src/*/||file[idea]:idea-live-templates/testData/*/||file[idea-maven_main]:*/||file[idea-repl]:*/||file[idea-test-framew...

    }

    def "adds extension to root project"() {
        when:
        applyPluginToProjects()

        then:
        project.idea instanceof IdeaModel
        project.idea.project != null
        project.idea.project.location.get().asFile == project.file("test-project.ipr")
        project.idea.module.outputFile == project.file("test-project.iml")
    }

    def "adds extension to child project"() {
        when:

// tag::module-before-merged[]
// tag::module-when-merged[]
import org.gradle.plugins.ide.idea.model.Module
// end::module-when-merged[]
// end::module-before-merged[]

// tag::module-when-merged[]
import org.gradle.plugins.ide.idea.model.ModuleDependency
// end::module-when-merged[]

// tag::project-before-merged[]
import org.gradle.plugins.ide.idea.model.Project
// end::project-before-merged[]

// tag::project-with-xml[]

            customModuleContentRoot {}
            src { main { java {} } }
        }

        //when
        runTask 'idea', '''
apply plugin: "java"
apply plugin: "idea"

configurations {
  provided
  compileClasspath.extendsFrom(provided)
}

idea {
    pathVariables CUSTOM_VARIABLE: file('customModuleContentRoot').parentFile

    module {
        name = 'foo'

import org.gradle.test.fixtures.maven.MavenFileRepository
import org.gradle.tooling.model.idea.BasicIdeaProject
import org.gradle.tooling.model.idea.IdeaContentRoot
import org.gradle.tooling.model.idea.IdeaModule
import org.gradle.tooling.model.idea.IdeaModuleDependency
import org.gradle.tooling.model.idea.IdeaProject
import org.gradle.tooling.model.idea.IdeaSingleEntryLibraryDependency
import org.gradle.util.GradleVersion

        def location = project.idea.project.location

        then:
        project.idea.project.outputFile == project.file("test-project.ipr")
        location.get().asFile == project.idea.project.outputFile

        when:
        project.idea.project.outputFile = project.file("other.ipr")

        then:
        location.get().asFile == project.idea.project.outputFile
    }

    }

    @Test
    @ToBeFixedForConfigurationCache
    void dslSupportsShortFormsForModule() {
        runTask('idea', """
apply plugin: 'idea'

idea.module.name = 'X'
assert idea.module.name == 'X'

idea {
    module.name += 'X'
    assert module.name == 'XX'
}

idea.module {
    name += 'X'
    assert name == 'XXX'
}

""")
    }

    @Test

            allprojects {
                apply plugin: 'java'
                apply plugin: 'idea'
            }

            project(':contrib') {
                idea.module {
                    name = 'cool-contrib'
                }
            }
        """

        executer.withTasks("idea").run()
        assert getFile(project: 'shared/api', "shared-api.iml").exists()