Skip to content

FLUT-1020062: Enhanced Flutter Installation UG documentation #1490

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Harsha-SF4223 wants to merge 3 commits into
base: master
Choose a base branch
from
Open

FLUT-1020062: Enhanced Flutter Installation UG documentation #1490

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
763141a
Merge pull request #1482 from Syncfusion-Content/hotfix/hotfix-v34.1.29
SyncfusionBuild Jul 10, 2026
36becf2
FLUT-1020069 Enhanced the installation section of Flutter user guide
sfHariHaraSudhan Jul 13, 2026
cfe5d3c
Updated description content
Harsha-SF4223 Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Flutter/installation/Installation-FAQ.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ documentation: ug

# Installation - Frequently Asked Questions (FAQs)

For more information regarding installation-related issues, please refer [to our installation troubleshooting guide.](https://help.syncfusion.com/flutter/installation/installation-errors)
For more information regarding installation-related issues, please refer to our [installation troubleshooting guide](https://help.syncfusion.com/flutter/installation/installation-errors).
24 changes: 12 additions & 12 deletions Flutter/installation/Installation-errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ documentation: ug

# Common Installation Errors

This article describes the most common installation errors, along with their causes and solutions
This article describes the most common installation errors, along with their causes and solutions.

* [Unlocking the license installer using the trial key](https://help.syncfusion.com/flutter/installation/installation-errors#unlocking-the-license-installer-using-the-trial-key)
* [License has expired](https://help.syncfusion.com/flutter/installation/installation-errors#license-has-expired)
Expand All @@ -31,7 +31,7 @@ You are attempting to use a trial unlock key to unlock the licensed installer.

### Suggested solution

Only a licensed unlock key can unlock a licensed installer. So, to unlock the licensed installer, use the licensed unlock key. To generate the licensed unlock key, refer to [this article](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account) article.
Only a licensed unlock key can unlock a licensed installer. Use a licensed unlock key to unlock the licensed installer. To generate the licensed unlock key, refer to [this article](https://support.syncfusion.com/kb/article/2757/how-to-generate-syncfusion-setup-unlock-key-from-syncfusion-support-account).


## License has expired
Expand All @@ -54,7 +54,7 @@ You can choose from the options listed below.

1. You can renew your subscription [here](https://www.syncfusion.com/account/my-renewals).
2. You can get a new license [here](https://www.syncfusion.com/sales/teamlicense).
3. You can reach out to our sales team by emailing <sales@syncfusion.com>.
3. You can reach out to our sales team by emailing sales@syncfusion.com.
4. You can also extend the 30-day trial period after your trial license has expired.


Expand All @@ -78,7 +78,7 @@ The following are possible causes of this error:

* When your trial period expired
* When you don't have a license or an active trial
* You are not the license holder of your license
* You are not assigned as the license holder for this license.
* Your account administrator has not yet assigned you a license.

### Suggested solution
Expand All @@ -87,8 +87,8 @@ You can choose from the options listed below.

1. You can get a new license [here](https://www.syncfusion.com/sales/teamlicense).
2. Contact your account administrator.
3. Send an email to <clientrelations@syncfusion.com> to request a license.
4. You can reach out to our sales team by emailing <sales@syncfusion.com>.
3. Send an email to clientrelations@syncfusion.com to request a license.
4. You can reach out to our sales team by emailing sales@syncfusion.com.

## Unable to install because of another installation

Expand All @@ -100,17 +100,17 @@ You can choose from the options listed below.

### Reason

You are trying to install when another installation is already running in your machine.
You are trying to install when another installation is already running on your machine.

### Suggested solution

Open and terminate the msiexec process in the task manager and then continue to install Syncfusion<sup>&reg;</sup>. If the problem is still present, restart the computer and try Syncfusion<sup>&reg;</sup> installer.
Open and terminate the msiexec process in the task manager and then continue to install Syncfusion<sup>&reg;</sup>. (Note: msiexec is the Windows Installer service. These steps apply to Windows only.) If the problem is still present, restart the computer and try Syncfusion<sup>&reg;</sup> installer.

1. Open the Windows Task Manager.

2. Browse the Details tab.

3. Select the msiexec.exe and click **End task**.
3. Select the msiexec.exe process and click **End task**.

![Task Manager](Errors/Installation_Errors_img5.png)

Expand All @@ -132,15 +132,15 @@ Open and terminate the msiexec process in the task manager and then continue to

### Reason

You have enabled controlled folder access settings on your computer.
You have enabled controlled folder access settings on your machine.

### Suggested solution

**Suggestion 1:**

1. We will ship our demos in the public documents folder by default.
2. You have controlled folder access enabled on your machine, so our demos cannot be installed in the documents folder. If you need to install our demos in the Documents folder, follow the steps in this [link](https://support.microsoft.com/en-us/windows/allow-an-app-to-access-controlled-folders-b5b6627a-b008-2ca2-7931-7e51e912b034) and disable the controlled folder access.
3. You can enable this option after the installing our Syncfusion<sup>&reg;</sup> setup.
2. You have controlled folder access enabled on your machine, so our demos cannot be installed in the Documents folder. If you need to install our demos in the Documents folder, follow the steps in this [link](https://support.microsoft.com/en-us/windows/allow-an-app-to-access-controlled-folders-b5b6627a-b008-2ca2-7931-7e51e912b034) and disable the controlled folder access.
3. After installing our Syncfusion<sup>&reg;</sup> setup, re-enable controlled folder access if needed.

**Suggestion 2:**

Expand Down
23 changes: 11 additions & 12 deletions Flutter/installation/linux-installer/how-to-download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: post
title: Downloading Syncfusion Flutter Linux installer - Syncfusion
description: Learn here about the how to download Syncfusion Flutter linux installer packages from syncfusion website.
description: Learn here how to download the Syncfusion Flutter Linux installer packages from the Syncfusion website.
platform: flutter
control: Installation and Deployment
documentation: ug
Expand All @@ -22,42 +22,42 @@ You can download the Syncfusion<sup>&reg;</sup> installer from [Syncfusion<sup>&
Our 30-day trial can be downloaded in two ways.

* Download Free Trial Setup
* Start Trials if using components through [NuGet.org](https://www.nuget.org/packages?q=syncfusion)
* Start Trials if using components through pub.dev


### Download Free Trial Setup

1. You can evaluate our 30-day free trial by visiting the [Download Free Trial](https://www.syncfusion.com/downloads) page and select the product
2. After completing the required form or logging in with your registered Syncfusion<sup>&reg;</sup> account, you can download the trial installer from the confirmation page. (as shown in below screenshot.)
1. You can evaluate our 30-day free trial by visiting the [Download Free Trial](https://www.syncfusion.com/downloads) page, select the product, and select the Flutter platform.
2. After completing the required form or logging in with your registered Syncfusion<sup>&reg;</sup> account, you can download the trial installer from the confirmation page (as shown in the screenshot below).

![Trial and downloads of Syncfusion Flutter](images/trial-confirmation.png)

3. With a trial license, only the latest version's trial installer can be downloaded.
4. Unlock key is not required to install the Syncfusion<sup>&reg;</sup> Flutter Linux trial installer.
5. Before the trial expires, you can download the trial installer at any time from your registered account's [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page (as shown in below screenshot.)
5. Before the trial expires, you can download the trial installer at any time from your registered account's [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page (as shown in the screenshot below).

![Trial and downloads of Syncfusion Flutter](images/trial-download.png)

6. Click the More Download Options (element 2 in the above screenshot) button to get the Flutter Product Offline trial installer which is available in ZIP format.

![License and downloads of Syncfusion Flutter](images/start-trial-download-offline-installer.png)

### Start Trials if using components through [NuGet.org](https://www.nuget.org/packages?q=syncfusion)
### Start Trials if using components through pub.dev

You should initiate an evaluation if you have already obtained our components through [NuGet.org](https://www.nuget.org/packages?q=syncfusion)
You should initiate an evaluation if you have already obtained our components through pub.dev.

1. You can start your 30-day free trial from the [Start Trial](https://www.syncfusion.com/account/manage-trials/start-trials) page from your account.
1. You can start your 30-day free trial from the [Start Trial](https://www.syncfusion.com/account/manage-trials/start-trials) page in your account.

N> You can generate the license key for your active trial products from [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page. This license key will be mandatory to use our trial products in your application. To know more about License key, refer this [help topic](https://help.syncfusion.com/common/essential-studio/licensing/overview).

![Trial and downloads of Syncfusion Flutter](images/start-trial-download.png)

2. To access this page, you must sign up\log in with your Syncfusion<sup>&reg;</sup> account.
2. To access this page, you must sign up/log in with your Syncfusion<sup>&reg;</sup> account.
3. Begin your trial by selecting the Syncfusion<sup>&reg;</sup> product.

N> If you've already used the trial products and they haven't expired, you won't be able to start the trial for the same product again.

4. After you've started the trial, go to the [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page to get the latest version trial installer. You can generate the [unlock key](https://www.syncfusion.com/kb/8069/how-to-generate-unlock-key-for-essentials-studio-products) and [license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-generate) here at any time before the trial period expires. (as shown in below screenshot.)
4. After you've started the trial, go to the [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page to get the latest version trial installer. You can generate the [unlock key](https://www.syncfusion.com/kb/8069/how-to-generate-unlock-key-for-essentials-studio-products) and [license key](https://help.syncfusion.com/common/essential-studio/licensing/how-to-generate) here at any time before the trial period expires (as shown in the screenshot below).

![License and downloads of Syncfusion Flutter](images/start-trial-download-installer.png)

Expand All @@ -72,8 +72,7 @@ You should initiate an evaluation if you have already obtained our components th

![License and downloads of Syncfusion Flutter](images/license-download.png)

4. Unlock key is not required to install the Syncfusion<sup>&reg;</sup> Flutter Linux trial installer.
5. For Linux OS, ZIP formats is available for download.
4. Only ZIP format is available for Linux.

![License and downloads of Syncfusion Flutter](images/Linux_Download.PNG)

Expand Down
32 changes: 20 additions & 12 deletions Flutter/installation/linux-installer/how-to-install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: post
title: Installing Syncfusion Flutter Linux installer - Syncfusion
description: Learn here about how to install Syncfusion Flutter linux installer after downloading from our Syncfusion website.
description: Learn here how to install the Syncfusion Flutter Linux installer after downloading it from the Syncfusion website.
platform: flutter
control: Installation and Deployment
documentation: ug
Expand All @@ -10,33 +10,41 @@ documentation: ug

# Installing Syncfusion<sup>&reg;</sup> Flutter Linux installer

## Step-by-Step Installation
## Step-by-step installation

The steps below show how to install Flutter Linux installer.

1. Extract the Syncfusion<sup>&reg;</sup> Flutter Linux installer(.zip) file. The files are extracted in your machine.
1. Extract the Syncfusion<sup>&reg;</sup> Flutter Linux installer (.zip) file. The files are extracted on your machine.

![Welcome wizard](images/Linux_Installer1.png)


2. The Linux zip file contains the following folders.
2. The Linux zip file contains the following folders:
- Samples
- Shortcuts
- Licensing

![License Agreement](images/Linux_Installer2.png)

N> The Unlock key is not required to install the Linux installer.


4. You can launch the demo source and use the NuGet packages included in the Linux installer.
3. You can launch the samples from the extracted folders to explore the Syncfusion Flutter widgets.


5. Run the following command in linux machine to deploy the ASP.NET Core samples

**dotnet restore projectname -s \nuget** in order to restore.
4. You can access the pub.dev packages included in the Linux installer.

## License key registration in samples

After the installation, the license key is required to register the demo source that is included in the Linux installer. To learn about the steps for license registration for the Flutter Linux installer, please refer to this.
After the installation, if you are using Syncfusion<sup>&reg;</sup> controls prior to version 18.3.0.x, you must register the license key. To learn about the steps for license registration, please refer to the [licensing overview](https://help.syncfusion.com/flutter/licensing/overview).

Register the license key in the **main method** of your application and import the `syncfusion_flutter_core/core.dart` library:

If you are using Syncfusion<sup>&reg;</sup> controls prior to version 18.3.0.x, please follow the following steps to register your license key.
```dart
import 'package:syncfusion_flutter_core/core.dart';

Register the license key in the [main method](https://help.syncfusion.com/flutter/licensing/overview) of your example and import the ‘syncfusion_flutter_core/core.dart’ library.
void main() {
// Register Syncfusion license
SyncfusionLicense.registerLicense('YOUR LICENSE KEY');
runApp(const MyApp());
}
```
17 changes: 8 additions & 9 deletions Flutter/installation/mac-installer/how-to-download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: post
title: Downloading Syncfusion Flutter Mac installer - Syncfusion
description: Learn here about the how to download Syncfusion Flutter mac installer packages from syncfusion website.
description: Learn here how to download the Syncfusion Flutter Mac installer packages from the Syncfusion website.
platform: flutter
control: Installation and Deployment
documentation: ug
Expand All @@ -19,34 +19,34 @@ Syncfusion<sup>&reg;</sup> provides Flutter Mac installer for both evaluation an
## Download the Trial Version

1. You can evaluate our 30-day free trial by visiting the [Download Free Trial](https://www.syncfusion.com/downloads) page and select the Flutter platform.
2. After completing the required form or logging in with your registered Syncfusion<sup>&reg;</sup> account, you can download the Flutter trial installer from the confirmation page. (as shown in below screenshot.)
2. After completing the required form or logging in with your registered Syncfusion<sup>&reg;</sup> account, you can download the Flutter trial installer from the confirmation page (as shown in the screenshot below).

![Trial and downloads of Syncfusion Essential Studio](images/trial-confirmation.png)

3. With a trial license, only the latest version's trial installer can be downloaded.
4. Unlock key is not required to install the Syncfusion<sup>&reg;</sup> Flutter Mac trial installer.
5. Before the trial expires, you can download the trial installer at any time from your registered account's [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page (as shown in below screenshot.)
5. Before the trial expires, you can download the trial installer at any time from your registered account's [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page (as shown in the screenshot below).

![Trial and downloads of Syncfusion Essential Studio](images/trial-download.png)

6. Click the More Download Options (element 2 in the above screenshot) button to get the Essential Studio<sup>&reg;</sup> Flutter Offline trial installer which is available in DMG format.
6. Click the More Download Options (element 2 in the above screenshot) button to get the Essential Studio<sup>&reg;</sup> Flutter Offline trial installer. Select Mac OS as the platform. The installer is available in DMG format.

![License and downloads of Syncfusion Essential Studio](images/Mac_Download.PNG)

### Start Trials if using components through [Pub.dev](https://pub.dev/packages?q=Syncfusion)

You should initiate an evaluation if you have already obtained our components through [Pub.dev](https://pub.dev/packages?q=Syncfusion)

1. You can start your 30-day free trial for Flutter from the [Start Trial](https://www.syncfusion.com/account/manage-trials/start-trials) page from your account.
1. You can start your 30-day free trial for Flutter from the [Start Trial](https://www.syncfusion.com/account/manage-trials/start-trials) page in your account.

![Trial and downloads of Syncfusion Essential Studio](images/start-trial-download.png)

2. To access this page, you must sign up\log in with your Syncfusion<sup>&reg;</sup> account.
2. To access this page, you must sign up/log in with your Syncfusion<sup>&reg;</sup> account.
3. Begin your trial by selecting the Flutter product.

N> If you've already used the trial products and they haven't expired, you won't be able to start the trial for the same product again.

4. After you've started the trial, go to the [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page to get the latest version trial installer. You can generate the [unlock key](https://support.syncfusion.com/kb/article/7053/how-to-generate-unlock-key-for-essentials-studio-products) and [license key](https://help.syncfusion.com/flutter/licensing/overview) here at any time before the trial period expires. (as shown in below screenshot.)
4. After you've started the trial, go to the [Trials & Downloads](https://www.syncfusion.com/account/manage-trials/downloads) page to get the latest version trial installer. You can generate the [unlock key](https://support.syncfusion.com/kb/article/7053/how-to-generate-unlock-key-for-essentials-studio-products) and [license key](https://help.syncfusion.com/flutter/licensing/overview) here at any time before the trial period expires (as shown in the screenshot below).

![License and downloads of Syncfusion Essential Studio](images/start-trial-download-installer.png)

Expand All @@ -61,8 +61,7 @@ You should initiate an evaluation if you have already obtained our components th

![License and downloads of Syncfusion Essential Studio](images/license-download.png)

4. Unlock key is not required to install the Syncfusion Flutter Mac trial installer.
5. For Mac OS, DMG formats is available for download.
4. Only DMG format is available for Mac.

![License and downloads of Syncfusion Essential Studio](images/Mac_Download.PNG)

Expand Down
Loading