Problem:
When activating a valid Bunifu Framework license in the WinForms UI (versions 7.0-8.0), you may encounter the error:

“The license details you entered are incorrect. Please confirm then try again.”

This issue typically arises from conflicts with outdated controls or residual files from previous installations.

Resolution Steps

1. Prepare Your Environment

  • Close Visual Studio: Ensure all instances are fully closed (check Task Manager for lingering processes).
  • Download the Licensing CLI Tool:

2. Clear Existing Licenses

  1. Extract the CLI Tool: Unzip the downloaded folder.
  2. Open the Command Prompt in the CLI Directory:
    • Navigate to the unzipped folder.
    • Type cmd in the folder’s address bar and press Enter.
  3. Remove Old Licenses: 
    blc --del-ui

    This deletes all cached licenses tied to your system.

3. Activate Your License

  1. Run the activation command: 
    blc --ac-ui
  2. Enter your Bunifu account email and license key when prompted.

4. Reinstall Bunifu Packages

  1. Create a New Windows Forms Project:
    • Open Visual Studio (run as Administrator for best results).
    • Start a new project to avoid legacy conflicts.
  2. Install Bunifu v7.2.0 via NuGet:
    • Go to Tools > NuGet Package Manager > Manage NuGet Packages for Solution.
    • Search for Bunifu.UI.WinForms and install v7.2.0.
  3. Validate Installation:
    • Open Form1, drag Bunifu controls onto the form, and build/run the project.
    • If successful, proceed to upgrade.

5. Upgrade to v8.0.0

  1. Update via NuGet:
    • Return to NuGet Package Manager and upgrade to v8.0.0.
  2. Resolve Framework Errors:
    • If errors like “controls not supported in target framework” appear:
      • Delete problematic controls from the form.
      • Re-add them from the updated v8.0.0 toolbox.
      • Rebuild the project.

6. Clean Up Legacy Files

(Critical for resolving persistent conflicts)

  1. Delete Old Bunifu Files:
    • Navigate to your project’s root folder (e.g., %USERPROFILE%\source\repos\YourProject).
    • Remove all Bunifu-related folders in the packages directory.
  2. Edit Configuration Files:
    • Open packages.config and delete all XML lines referencing Bunifu (e.g., <package id="Bunifu.UI.WinForms" ... />).
  3. Remove DLL References:
    • In Visual Studio’s Solution Explorer, right-click References and remove any Bunifu DLLs.

7. Final Validation

  1. Reinstall v7.2.0 and Test:
    • Re-add Bunifu v7.2.0 via NuGet.
    • Create a new test form with Bunifu controls and ensure no errors occur.
  2. Upgrade to v8.0.0 Again:
    • Repeat the upgrade process.
    • Delete the test form and rebuild your main project.

Still Stuck?

If licensing issues persist:

  • Contact Support: Email [email protected] or use the live chat.
  • Renew Expired Licenses: These steps only apply to active licenses.

Note: Always ensure your Visual Studio and Windows are fully updated to avoid compatibility issues.