1 Star 1 Fork 1

Gitee 极速下载 / Pkl

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
此仓库是为了提升国内下载速度的镜像仓库,每日同步一次。 原始仓库: https://github.com/apple/pkl
克隆/下载
DEVELOPMENT.adoc 4.86 KB
一键复制 编辑 原始数据 按行查看 历史
Daniel Chao 提交于 2024-05-28 15:56 . Add support for Windows (#492)

Development

Setup

  1. (mandatory) Install OpenJDK 17 or higher

  2. (recommended) Install IntelliJ IDEA 2023.x
    To import the project into IntelliJ, go to File→Open and select the project’s root directory. If the project is opened but not imported, look for a popup in the lower right corner and click its "Import Gradle Project" link.

  3. (recommended) Install gng
    gng enables to run Gradle commands with gw (instead of ./gradlew) from any subdirectory.

  4. (recommended) Install jenv and plugins
    jenv use specific JDK versions in certain subdirectories. Pkl comes with a .java-version file specifying JDK 17.
    Enable jenv plugins for better handling by gradle:

    jenv enable-plugin gradle
    jenv enable-plugin export

Common Build Commands

gw clean
gw test          # run all tests except native executable tests
gw testNative    # run native executable tests
gw spotlessApply # fix code formatting
gw build         # build everything except native executables
gw buildNative   # build macOS executable on macOS,
                 # Linux and Alpine executables on Linux
                 # (Alpine executable is only built if ~/staticdeps/bin/musl-gcc exists)

pkl-cli/build/executable/jpkl                   # run Java executable
pkl-cli/build/executable/pkl-macos-amd64        # run Mac executable
pkl-cli/build/executable/pkl-linux-amd64        # run Linux executable
pkl-cli/build/executable/pkl-alpine-linux-amd64 # run Alpine Linux executable
pkl-cli/build/executable/pkl-windows-amd64.exe  # run Windows executable

Update Gradle

  1. Go to https://gradle.org/release-checksums/ and copy the checksum for the new Gradle version

  2. Run the following command twice (until it prints UP-TO-DATE):

    gw wrapper --gradle-version [version] --gradle-distribution-sha256-sum [sha]
  3. Commit the updated wrapper files

Update Dependencies

  1. (optional) Update gradle/libs.version.toml based on version information from https://search.maven.org, https://plugins.gradle.org, and GitHub repos

  2. Run gw updateDependencyLocks

  3. Validate changes with gw build buildNative

  4. Review and commit the updated dependency lock files

Code Generation

  • Truffle code generation is performed by Truffle’s annotation processor, which runs as part of task :pkl-core:compileJava

    • Output dir is generated/truffle/

  • ANTLR code generation is performed by task :pkl-core:generateGrammarSource

    • Output dir is generated/antlr/

Remote JVM Debugging

To enable remote JVM debugging when running Gradle tasks (e.g. test), add the flag -Djvmdebug=true. This will listen on port 5005.

Example: ./gradlew test -Djvmdebug=true

Java
1
https://gitee.com/mirrors/Pkl.git
git@gitee.com:mirrors/Pkl.git
mirrors
Pkl
Pkl
main

搜索帮助