update_center 1.0.0-alpha.3

A package that allows you to implement your own update system for your application.

Update Center

Flutter plugin that allows you to implement multi-check for updates for different platforms Android, IOS, Windows.

IMPORTANT INFORMATION! ⚠

This plugin is under active development and many features have not yet been implemented. The plugin now works well with Android and Windows, you can now use the plugin for these platforms. IOS is partially implemented, but it can also work, but improvements are needed. Downloads and checking via sha256checksum are not yet implemented. I was not able to check the functionality of the IOS plugin, since I do not have access to an iPhone or Mac Book, but in theory it should work, you just can check the functionality of the IOS plugin in your project and If you find errors, write to this mail [e-mail] or add a comment to the issues in the github project https://github.com/Smolla-ITc/update_center/issues.

What has been implemented so far.

• Automatic update check depending on the platform the plugin runs on.
• Show notifications about download progress and download errors (The plugin does not yet know how to issue a notification request this will be added in subsequent updates).
• The plugin may prohibit skipping an update if the code in json is higher than the local versionCode, preventing the dialog or bottom sheet from being closed.
• The plugin may partially work with downloaded files. They will be deleted after the update is complete. This works on both Android and Windows. Download files are stored in Windows directories – download folder “/UpdateCenter/” Android - internal memory. Improvements are also needed.
• Once the download is complete, the files themselves open in supported formats. In Windows zip and exe and also any file. And Android is similar.
• And there is also flexible customization of the plugin, see example below. These are not all the settings many more settings will be added in the future.

Screenshots android (Windows is identical to android)

Getting started

The plugin works with a Json file so make sure you have somewhere to place this file.

Add package to your pubspec.yaml

dependencies:
  update_center: ^1.0.0-alpha.3

Json file structure

{
  "android": {
    "versionCode": 2,
    "versionName": "1.1.0",
    "downloadUrl": "https://example.com/UpdateCenetr/app.apk",
    "changeLog": "- bug fixed; \n- new ui;",
    "sourceUrl": "https://example.com/",
    "sha256checksum": "",
    "minSupport": 1
  },

  "ios": {
    "versionCode": 2,
    "versionName": "1.1.0",
    "changeLog": "- Bug fixes and performance improvements. \n- new ui",
    "sourceUrl": "https://example.com/",
    "minSupport": 1
  },

  "windows": {
    "versionCode": 34,
    "versionName": "5.0.0",
    "downloadUrl": "https://example.com/UdateCenter/app-windows.exe",
    "changeLog": "- Bug fixes and performance improvements. \n- New Icon;",
    "sourceUrl": "https://example.com/",
    "sha256checksum": "",
    "minSupport": 14
  }
}

Description of the json structure

{
    "android": {
        "versionCode": 2, // Integer representing the new version code for Android
        "versionName": "1.1.0", // String representing the new version name for Android
        "downloadUrl": "https://example.com/UpdateCenetr/app.apk", // URL to download the new Android APK
        "changeLog": "- bug fixed; \n- new ui;", // Change log detailing what's new or fixed in this version
        "sourceUrl": "https://example.com/", // URL to the source or more information about the update
        "sha256checksum": "", // SHA-256 checksum for verifying the integrity of the downloaded file (optional)
        "minSupport": 1 // Minimum supported version code; devices with a lower version code will be forced to update
    },

    "ios": {
        "versionCode": 2, // Integer representing the new version code for iOS
        "versionName": "1.1.0", // String representing the new version name for iOS
        "changeLog": "- Bug fixes and performance improvements. \n- new ui", // Change log for iOS version
        "sourceUrl": "https://example.com/", // URL for more information or source for the iOS update
        "minSupport": 1 // Minimum supported version code for iOS
    },

    "windows": {
        "versionCode": 34, // Integer representing the new version code for Windows
        "versionName": "5.0.0", // String representing the new version name for Windows
        "downloadUrl": "https://example.com/UdateCenter/app-windows.exe", // URL to download the new Windows application
        "changeLog": "- Bug fixes and performance improvements. \n- New Icon;", // Change log for the Windows version
        "sourceUrl": "https://example.com/", // URL for more information or source for the Windows update
        "sha256checksum": "", // SHA-256 checksum for the Windows file (optional)
        "minSupport": 14 // Minimum supported version code for Windows
    }
}

Example of plugin initialization and configuration

First you need to give permissions in the Android Manifest to read files and install apk files.

Paste these lines into the file if you don't have them.

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

Full plugin settings.

Go to main file at this link to find out more