commit | a7203fc4383996bc4c0291f59605a649fcc9528e | [log] [tgz] |
---|---|---|
author | Doug Ilijev <doilij@microsoft.com> | Thu Feb 09 23:16:50 2017 |
committer | Doug Ilijev <doilij@microsoft.com> | Thu Feb 09 23:16:50 2017 |
tree | 1db418433ffc3cf831fdf6574b6cd40acc93b5c8 | |
parent | b5c277f4d7bf4edde15dc85982f27a258ce799a0 [diff] | |
parent | beb522dcbe2bb30391aa6366a7d21a908db7b005 [diff] |
[MERGE #2490 @dilijev] Add -v and --version flags to ch to print ChakraCore version. Merge pull request #2490 from dilijev:version-r14 Partially addresses #109 and #2472. This is intended as a first pass at the issue to provide some information at this point. Later, we plan to add more information such as whether a binary was produced as a developer build or an official build, what specific commit the binary was built from, which branch, which machine, etc. The specific set of information that we plan to provide is still being discussed in #109. ``` ch /v ch /version ch -v ch --v ch -version ch --version ``` (Supporting `-` and `--` prefixes for short and long flag names is consistent with how we process all behaviors. The logic I used here is a replica of that in `CmdLineArgsParser::Parse`.) The above all display the version information for `ch` and `ChakraCore` as `<major>.<minor>.<patch>.<QFE>` (note: by convention, ChakraCore's `QFE` is always `0`). For example on Windows for ChakraCore 1.4.1 with `ch.exe` and `ChakraCore.dll` from the same build: ``` $ ch -v ch.exe version 1.4.1.0 chakracore.dll version 1.4.1.0 ``` If with the same `ch.exe`, if `ChakraCore.dll` was from, e.g., a 2.0.0 build: ``` $ ch -v ch.exe version 1.4.1.0 chakracore.dll version 2.0.0.0 ``` On Linux: ``` ~/dev/ChakraCore$ ./BuildLinux/Release/ch -v ch version 1.4.1.0 ``` This flag is available in all flavors (including Release). --- Updating the help message. Also enable `-h` and `-help` as per request in #2472. Enables `-h` and `-help` for non-release builds, and `-?`, `-h`, and `-help` for release builds. Messages will look as follows. debug/test builds: ``` Usage: ch.exe [-v|-version] [-h|-help] [-?] [flaglist] <source file> -v|-version Displays version info -h|-help Displays this help message -? Displays this help message with complete [flaglist] info ``` release builds: ``` Usage: ch.exe [-v|-version] [-h|-help|-?] <source file> Note: [flaglist] is not supported in Release builds; try a Debug or Test build to enable these flags. -v|-version Displays version info -h|-help|-? Displays this help message ``` The distinction is that `-?` is already implemented in debug/test builds to display full information about the `[flaglist]` options. This is a minimal change here that will result in guiding the user more accurately in all build flavors, the effect of which is that `-?` in debug/test builds is still the only way to get information about the `[flaglist]` options.
ChakraCore is the core part of Chakra, the high-performance JavaScript engine that powers Microsoft Edge and Windows applications written in HTML/CSS/JS. ChakraCore supports Just-in-time (JIT) compilation of JavaScript for x86/x64/ARM, garbage collection, and a wide range of the latest JavaScript features. ChakraCore also supports the JavaScript Runtime (JSRT) APIs, which allows you to easily embed ChakraCore in your applications.
You can stay up-to-date on progress by following the MSEdge developer blog.
Debug | Test | Release | |
---|---|---|---|
Windows (x64) | |||
Windows (x86) | |||
Windows (ARM) | |||
Ubuntu 16.04 (x64) | |||
Ubuntu 16.04 (x64 static) | |||
OS X 10.9 (x64 static) |
If you see badges reading “Build: Unknown” it is likely because a build was skipped due to changes being only in files known not to affect the health of the build.
Above is a table of our rolling build status. We run additional builds on a daily basis. See Build Status for the status of all builds.
If you believe you have found a security issue in ChakraCore, please share it with us privately following the guidance at the Microsoft Security TechCenter. Reporting it via this channel helps minimize risk to projects built with ChakraCore.
You can build ChakraCore on Windows 7 SP1 or above, and Windows Server 2008 R2 or above, with either Visual Studio 2013 or 2015 with C++ support installed. Once you have Visual Studio installed:
git clone https://github.com/Microsoft/ChakraCore.git
Build\Chakra.Core.sln
in Visual StudioMore details in Building ChakraCore.
Alternatively, you can get pre-built ChakraCore binaries from our NuGet Packages.
Once built, you have a few options for how you can use ChakraCore:
Build\VcBuild\bin\${platform}_${configuration}
Build\VcBuild\bin\x64_debug
)A note about using ChakraCore: ChakraCore is the foundational JavaScript engine, but it does not include the external APIs that make up the modern JavaScript development experience. For example, DOM APIs like document.write()
are additional APIs that are not available by default and would need to be provided. For debugging, you may instead want to use print()
.
Contributions to ChakraCore are welcome. Here is how you can contribute to ChakraCore:
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Please refer to Contribution guidelines for more details.
Code licensed under the MIT License.
For details on our planned features and future direction please refer to our roadmap.
For questions about ChakraCore, you can reach us on Gitter or open an issue and prefix the issue title with [Question]. See Question tag for already-opened questions.