linghengqian commented on code in PR #37733:
URL: https://github.com/apache/shardingsphere/pull/37733#discussion_r2686981593
##########
docs/document/content/user-manual/shardingsphere-jdbc/graalvm-native-image/_index.en.md:
##########
@@ -34,75 +34,108 @@ java.beans.Introspector was unintentionally initialized at
build time. To see wh
### Maven Ecology
-Users need to actively use the GraalVM Reachability Metadata central
repository.
The following configuration is for reference to configure additional Maven
Profiles for the project,
and the documentation of GraalVM Native Build Tools shall prevail.
```xml
<project>
- <dependencies>
- <dependency>
- <groupId>org.apache.shardingsphere</groupId>
- <artifactId>shardingsphere-jdbc</artifactId>
- <version>${shardingsphere.version}</version>
- </dependency>
- </dependencies>
-
- <build>
- <plugins>
- <plugin>
- <groupId>org.graalvm.buildtools</groupId>
- <artifactId>native-maven-plugin</artifactId>
- <version>0.11.3</version>
- <extensions>true</extensions>
- <configuration>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.shardingsphere</groupId>
+ <artifactId>shardingsphere-infra-reachability-metadata</artifactId>
+ <version>${shardingsphere.version}</version>
+ </dependency>
+ </dependencies>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.graalvm.buildtools</groupId>
+ <artifactId>native-maven-plugin</artifactId>
+ <version>0.11.3</version>
+ <extensions>true</extensions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
+```
+
+A more convenient configuration for testing third-party dependencies might
look like this,
+
+```xml
+<project>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.shardingsphere</groupId>
+ <artifactId>shardingsphere-jdbc</artifactId>
+ <version>${shardingsphere.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.shardingsphere</groupId>
+ <artifactId>shardingsphere-infra-reachability-metadata</artifactId>
+ <version>${shardingsphere.version}</version>
+ </dependency>
+ </dependencies>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.graalvm.buildtools</groupId>
+ <artifactId>native-maven-plugin</artifactId>
+ <version>0.11.3</version>
+ <extensions>true</extensions>
+ <configuration>
<buildArgs>
- <buildArg>-H:+UnlockExperimentalVMOptions</buildArg>
- <buildArg>-H:+AddAllCharsets</buildArg>
- <buildArg>-H:+IncludeAllLocales</buildArg>
+ <buildArg>-H:+UnlockExperimentalVMOptions</buildArg>
+ <buildArg>-H:+AddAllCharsets</buildArg>
+ <buildArg>-H:+IncludeAllLocales</buildArg>
</buildArgs>
- </configuration>
- <executions>
- <execution>
- <id>build-native</id>
- <goals>
- <goal>compile-no-fork</goal>
- </goals>
- <phase>package</phase>
- </execution>
- <execution>
- <id>test-native</id>
- <goals>
- <goal>test</goal>
- </goals>
- <phase>test</phase>
- </execution>
- </executions>
- </plugin>
- </plugins>
- </build>
+ </configuration>
+ <executions>
+ <execution>
+ <id>build-native</id>
+ <goals>
+ <goal>compile-no-fork</goal>
+ </goals>
+ <phase>package</phase>
+ </execution>
+ <execution>
+ <id>test-native</id>
+ <goals>
+ <goal>test</goal>
+ </goals>
+ <phase>test</phase>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
</project>
```
### Gradle Ecosystem
-Users need to actively use the GraalVM Reachability Metadata central
repository.
The following configuration is for reference to configure additional Gradle
Tasks for the project,
and the documentation of GraalVM Native Build Tools shall prevail.
-Due to the limitations of https://github.com/gradle/gradle/issues/17559 ,
-users need to introduce the JSON file of Metadata Repository through Maven
dependency.
-Reference https://github.com/graalvm/native-build-tools/issues/572 .
```groovy
plugins {
id 'org.graalvm.buildtools.native' version '0.11.3'
}
+dependencies {
+ implementation
'org.apache.shardingsphere:shardingsphere-infra-reachability-metadata:${shardingsphere.version}'
+}
+```
+A more convenient configuration for testing third-party dependencies might
look like this. Due to limitations outlined in
https://github.com/gradle/gradle/issues/17559 , users may need to include the
Metadata Repository's JSON file as a Maven dependency. See
https://github.com/graalvm/native-build-tools/issues/572 .
Review Comment:
The spacing between the URL and the symbol is to prevent Hugo from getting
incorrect links when rendering the document.
##########
docs/document/content/user-manual/shardingsphere-jdbc/graalvm-native-image/_index.en.md:
##########
@@ -117,19 +150,19 @@ graalvmNative {
}
}
metadataRepository {
- enabled.set(false)
+ enabled.set(false)
}
}
```
-### For build tools such as sbt that are not supported by GraalVM Native Build
Tools
+### sbt
-Such requirements require opening additional issues at
https://github.com/graalvm/native-build-tools
-and providing the Plugin implementation of the corresponding build tool.
+For build tools such as sbt that are not supported by GraalVM Native Build
Tools,
+you need to open an additional issue at
https://github.com/graalvm/native-build-tools and provide the corresponding
plugin implementation for the build tool.
## Usage restrictions
-1. The following algorithm classes are not available under GraalVM Native
Image due to the involvement of https://github.com/oracle/graal/issues/5522.
+1. The following algorithm classes are not available under GraalVM Native
Image due to the involvement of https://github.com/oracle/graal/issues/5522 .
Review Comment:
The spacing between the URL and the symbol is to prevent Hugo from getting
incorrect links when rendering the document.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
