Source sets & dependencies소스셋과 의존성

Where the package is패키지 위치

python {
    sourceSets {
        val commonMain by getting {
            srcDirs("src/commonMain/python")          // the pypackpack package
            metaDirs("src/commonMain/generated/meta") // .pyi stubs, merged into the bundle
            libDirs("src/commonMain/build/site-packages")
        }
    }
}

Dependencies의존성

python {
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("pyzmq")
                implementation("rpds-py==0.20.0")
            }
        }
        val androidMain by getting {
            dependencies {
                integration("pycomposeui")   // a Python package that depends on Kotlin
            }
        }
    }
}

Each variant gets the dependencies of commonMain, of its own family's source set (androidMain, iosMain or desktopMain) and of its flavor's <flavor>Main, and nothing else. They are installed for that variant's target triple, as wheels, and land in its bundle's python/ beside your modules.

각 변형은 commonMain, 자기 계열의 소스셋(androidMain, iosMain, desktopMain), 자기 플레이버의 <flavor>Main 의 의존성만 받습니다. 그 변형의 타깃 트리플용 wheel 로 설치되어, 번들의 python/ 에 모듈과 나란히 들어갑니다.

Package repositories패키지 저장소

python {
    defaultConfig {
        pip {
            autoUpdate = true                                  // uv add --upgrade
            repositories {
                central { setUrl("https://mirror.example/simple") }  // --default-index
                local { url = Paths.get("wheels").toUri().toString() } // --find-links
            }
        }
    }
}

central's first URL replaces PyPI; any further URLs are added as extra indexes. local is a directory of wheels. jit { } (building packages from recipes) is not supported yet: declaring it fails installPythonDependencies and the per-target install tasks with the reason, and only when there is something to install.

central 의 첫 URL 이 PyPI 를 대신하고, 나머지 URL 은 추가 인덱스가 됩니다. local 은 wheel 이 든 디렉터리입니다. jit { }(레시피로 패키지 빌드)는 아직 지원하지 않습니다. 선언하면 설치할 것이 있을 때만 installPythonDependencies 와 타깃별 설치 태스크가 이유와 함께 실패합니다.

ComposeCompose

python {
    buildFeatures {
        compose = true
    }
}

# gradle.properties (or -P on the command line)
python.compose.pythonxCompose=pythonx-compose==0.1.0      # or a directory of wheels
python.compose.kotlinModule=group:python-multiplatform-compose:version

compose = true installs pythonx-compose with the other dependencies and adds python-multiplatform-compose to Kotlin Multiplatform commonMain's implementation. Neither is published yet, so both locations come from these two Gradle properties and have no default. pythonxCompose is a pip requirement, or a directory of wheels, which is added to --find-links after any local repository. A missing pythonxCompose fails installPythonDependencies only; a missing kotlinModule fails configuration, because the dependency belongs to every Kotlin compilation. Without the Kotlin Multiplatform plugin only pythonx-compose is installed, with a warning.

compose = true 는 다른 의존성과 함께 pythonx-compose 를 설치하고, Kotlin Multiplatform commonMain 의 implementation 에 python-multiplatform-compose 를 추가합니다. 둘 다 아직 배포되지 않았으므로 위치는 이 두 Gradle 속성으로 정하며 기본값이 없습니다. pythonxCompose 는 pip 요구사항이거나 wheel 디렉터리이고, 디렉터리는 local 저장소 뒤에 --find-links 로 추가됩니다. pythonxCompose 가 없으면 installPythonDependencies 만 실패하고, kotlinModule 이 없으면 구성 단계가 실패합니다. 그 의존성은 모든 Kotlin 컴파일에 속하기 때문입니다. Kotlin Multiplatform 플러그인이 없으면 경고와 함께 pythonx-compose 만 설치됩니다.