You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md
+29-5Lines changed: 29 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1560,22 +1560,46 @@ N> We have option to exclude the default Blink binaries from the installation pa
1560
1560
1561
1561
## How to Exclude BlinkBinaries or Runtime Files in Build or Deployment
1562
1562
1563
-
The runtime files, or blink binaries, will be copied into a bin or published folder while building and publishing the application.
1564
-
By including the <ExcludeAssets>native</ExcludeAssets> option in the package reference of the csproj file, you can exclude the runtime files or blink binaries from being copied into the bin or publish folder while building and publishing the application. But you need to place the BlinkBinaries in the server disk and set the BlinkPath in the BlinkConverterSettings to perform the conversion.
1563
+
When you build or publish the application, the Syncfusion HTML‑to‑PDF converter automatically copies the Blink runtime files (BlinkBinaries) into the <i>bin</i> or <i>publish</i> output folder. These binaries are required for HTML‑to‑PDF conversion at runtime. However, in certain deployment scenarios—such as reducing the deployment size or using a shared/system‑installed Chromium—you can exclude these files and instead provide the Blink binaries manually on the host machine.
1564
+
1565
+
To exclude BlinkBinaries during the build process, configure your project file depending on whether you are using <b>.NET Core/.NET or .NET Framework</b>.
1565
1566
1566
-
N> Using this approach, you can reduce the deployment size on your own servers.
1567
+
<b>Exclude BlinkBinaries in .NET Core</b>
1568
+
You can prevent runtime files from being included by restricting the package to <b>compile-only</b> assets using the <b>IncludeAssets</b> tag in the <b>PackageReference</b>. This stops all Blink runtime binaries from being copied into the output folder.
By using <b>IncludeAssets="compile"</b>, only the required compile-time metadata is included, and all runtime dependencies (BlinkBinaries) are excluded from the final build or publish output.
1585
+
1586
+
N> If you exclude runtime files, you must manually place BlinkBinaries on the server and configure BlinkPath in BlinkConverterSettings for conversion to work.
1587
+
1588
+
<b>Exclude BlinkBinaries in .NET Framework Projects</b>
1589
+
1590
+
For .NET Framework applications, Blink runtime files are included through a .targets file referenced in the project.
1591
+
To exclude BlinkBinaries, simply remove this import entry.
Removing this line prevents the Syncfusion<sup>®</sup> build targets from copying BlinkBinaries and other runtime files into your bin folder during build or publish.
1602
+
1603
+
N> By excluding BlinkBinaries, you can significantly reduce the size of your deployment package, especially in server environments where disk usage and deployment time matter.
0 commit comments