Skip to content

nrnoble/h5

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

h5 πŸš€ - C# to JavaScript compiler, now on .NET50

H5 is a modern fork of the original Bridge C# to Javascript compiler, updated to support multi-platform development using .NET 5.0 and .NET Standard 2.0 projects, while dropping support for legacy features and dependencies.

H5 is under active development, and targets a more integrated and faster development experience for C# web-developers. We're also planning to experiment with new ideas to improve compilation speed (such as aggressive caching of emitted code) and possibly integrating C# Source Generators) for even faster code generation.

Package NuGet Azure DevOps
Compiler Nuget Build Status
Base Library Nuget Build Status
Core Library Nuget Build Status
SDK Target Nuget Build Status
Json Library Nuget Build Status
dotnet template Nuget Build Status
Tesserae UI toolkit Nuget Build Status

Getting Started ⚑

Gitter

H5 is fully based on netstandard2.0 & net5.0, and removes all dependencies on the legacy .NET Framework coming from the original source-code.

To get started with it, you can use the following project template

<Project Sdk="h5.Target/0.0.*">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="h5" Version="*" />
    <PackageReference Include="h5.Core" Version="*" />
  </ItemGroup>
</Project>

The Sdk target above (<Project Sdk="h5.Target/0.0.*">) will automatically install (and update) the compiler as a dotnet global tool. You need to update the version /0.0.* to the latest Nuget package.

Don't forget to run dotnet restore to fill the versions with the latest values. You can also manually install it with:

dotnet tool update --global h5-compiler

You can also install a dotnet new template (latest version: Nuget):

dotnet new --install h5.Template::0.0.13606

And create a new project with:

dotnet new h5

Breaking Changes πŸ’₯

This fork introduces a series of breaking changes as part of the modernization effort:

  • Projects must explicitly target netstandard2.0.
  • Drop support to the legacy .csproj format (only SDK-style projects are supported)
  • Drop support for legacy (and unused) command line arguments (check h5 -h for the current supported arguments)
  • Compiler is now distributed as a dotnet global tool and have it's own versioning and auto-update on build (this can be disable by setting <UpdateH5>false<UpdateH5/> on your project file.
  • Retyped packages are not supported (as those are maintained by the Bridge authors, and cannot be built separately or consumed without the Bridge NuGet package).
  • Logging and Report options have been removed from the h5.json config file. Logging settings will be available only as a command line argument (and exposed as a Project file option in the future)
  • Hosted Compiler process (to speed up compilation and avoiding reloading assemblies that don't change often (like nuget packages), h5 introduces an off-process compiler server. For now, this process will open a terminal with the compilation logs - but this will be hidden in the future)

Update Notes πŸ“‘

To avoid any conflicts with the original Bridge ecosystem, all packages have been renamed. For upgrading, you can use the following mapping:

Other packages might be added in the future as we experiment with this fork, but we do not aim on providing any kind of Retyped replacement here. If you're missing any specific Retyped package, open an issue and I can take a look into publishing it derived from the Retyped ones.

About

πŸš€ The next generation C# to JavaScript compiler

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 81.1%
  • JavaScript 18.9%