Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2024-03-06-your-first-flutter-flame-game", "title": "Your First Flutter Flame Game", "summary": "Creating a game can be a really complex endeavor, especially when you want to support multiple platforms. Luckily, using Flame & Flutter can provide support for multiple platforms and an awesome developer experience in the process.", "date_modified": "2024-03-06T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2024-02-23-flutter-apprentice-book", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2024-02-23-flutter-apprentice-book", "title": "Flutter Apprentice", "summary": "This book is for developers who are new to Flutter, and also developers that already have some experience with building apps for the iOS and Android platforms, or web apps. I was lucky enough to be a co-author to this book.", "date_modified": "2024-02-23T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2023-10-17-chatgpt-tutorial-for-flutter-getting-started", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2023-10-17-chatgpt-tutorial-for-flutter-getting-started", "title": "ChatGPT Tutorial for Flutter: Getting Started", "summary": "Learn how to incorporate ChatGPT into your Flutter apps! In this tutorial, see how to leverage machine learning and ChatGPT with a real-world trivia app.", "date_modified": "2023-10-17T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2023-02-22-flutter-accessibility-getting-started", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2023-02-22-flutter-accessibility-getting-started", "title": "Flutter Accessibility: Getting Started", "summary": "Building a high-quality app is not only about its features and looks but also about how accessible it is to users, including people with disability.", "date_modified": "2023-02-22T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2022-11-25-how-to-encourage-app-updates-flutter", "content_html": "One big advantage when creating mobile apps is to offer new content and features to your users. This means that you will have to release new versions of your app with a higher cadence and, in turn, have many versions of your app out there, some even broken. This is a problem for app development and there's a great Flutter plugin that helps you solve it: upgrader.
In this tutorial you'll learn about the following:
\n\n\nKeep in mind: This tutorial assumes that you are a developer with experience publishing mobile apps to Google Play Store and Apple App Store as well as basic knowledge of Flutter, stateful widgets and package versioning.
\n
You'll work on Days Without Incidents, a simple incident counter app that supports many counters, styles, and a simple user experience. You can follow the tutorial by downloading the open source code available via GitHub. You should use Flutter, 3.0 or above to follow along.
\nWhen opening the project with your preferred IDE and remember to get the dependencies with flutter pub get.
Here’s a quick rundown of some important files you should be aware of:
\nIn an effort to help you understand the essentials, you can also check this Pull Request. It has all the changes required to handle app updates and version restrictions on your own.
\nupgrader worksNowadays most people use the auto-update feature of the app stores for Android and iOS, this helps to avoid having to update each app on the phone. Yet, there may be instances in which the device has not yet updated the app, or that the user is not auto-updating apps. This can turn into a big deal if you are looking to make releases with consistency (Release Early, Release Often) because it could cause version fragmentation issues.
\nVersion fragmentation will happen when there are too many versions of your app in the market. Each one could have different features, device support, screen support, and even API versions. This means that your infrastructure and services should support all these variations. This ends up making operations more expensive for the business.
\nThe solution? There are three things you can do to cut down the impact of version fragmentation:
\nThis is where upgrader comes in. It helps you put in place all those mechanisms in your app without too much overhead.
upgrader is a Flutter plugin that helps manage the user's installed version of your app. It allows you to check if the user has the latest version installed and if not, it guides the user to install it via stores with a dialog or widget.
The plugin can also enforce a minimum app version, and has built-in support RSS feeds with the AppCast standard used by Sparkle, and . Using the library helps you reduce version fragmentation and avoid potential bugs or broken app versions.
\nEnough chit-chat, it's time you dive into some code.
\nOne of the most common use cases for upgrader is to display a dialog when the current installed app is outdated compared to the store listing. Time you try it out, open lib/features/time_counter/pages/counter_page.dart and change CountersPage's build to the following:
@override\nWidget build(BuildContext context) {\n return Scaffold(\n appBar: const DWIAppBar(),\n body: UpgradeAlert(\n child: const SafeArea(\n child: _Body(),\n ),\n ),\n );\n}\nUpgradeAlert can wrap a widget, this allows you to place it as a wrapper of body and not having to worry about manual checks to the version.
\n\nTip: Remember to add this import at the top of the file:
\nimport 'package:upgrader/upgrader.dart';.
If you build and run the app right now you'll see the following:
\nThe plugin also has limited style customization for the dialog with the dialogStyle property in Upgrader which has two different options: UpgradeDialogStyle.cupertino and UpgradeDialogStyle.material (default). Change build again and change the style to be cupertino likeso:
@override\nWidget build(BuildContext context) {\n return Scaffold(\n appBar: const DWIAppBar(),\n body: UpgradeAlert(\n upgrader: Upgrader(dialogStyle: UpgradeDialogStyle.cupertino),\n child: const SafeArea(\n child: _Body(),\n ),\n ),\n );\n}\nBuild and run the app, it should look something like this:
\nNow go ahead and leave build as it was in the beginning:
@override\nWidget build(BuildContext context) {\n return const Scaffold(\n appBar: DWIAppBar(),\n body: SafeArea(\n child: _Body(),\n ),\n );\n}\nAnother common scenario is having an indicator in the UI to display that the installed version of the app is not up to date. Again, the plugin has a really good implementation for this via UpgradeCard.
Time to add UpgradeCard and see how it looks. Open lib/features/time_counter/widgets/counter_list.dart and change add this code after line 80:
UpgradeCard(),\nBuild and run the app, this is how it looks like:
\nAs you can see, UpgradeCard displays a card styled with Material Design, it uses the same content as UpgradeAlert but it does it inline instead of a dialog. Since in this case the card does not look great, then go ahead and delete the code you just added by deleting line 81.
Now, sometimes those two built-in behaviors are not enough in terms of user experience. An example may be to show an IconButton when there's an update available for the app. Let's give this example a try.
You will need to create a new widget that will work like UpgradeCard and UpgradeAlert. In fact, if you take a closer look to the library's code, you'll notice that both extend UpgradeBase which will make things a bit easier.
Start by creating the file lib/core/widgets/upgrade_widget.dart and add the following code:
\nimport 'dart:developer';\n\nimport 'package:flutter/material.dart';\nimport 'package:upgrader/upgrader.dart';\n\n/// Defines a builder function that allows you to create a custom widget\n/// that is displayed in a similar fashion as [UpgradeCard]\ntypedef UpgradeWidgetBuilder = Widget Function(\n BuildContext context,\n Upgrader upgrader,\n);\n\n/// A widget to display by checking upgrader info available.\nclass UpgradeWidget extends UpgradeBase {\n /// Creates a new [UpgradeWidget].\n UpgradeWidget({\n Key? key,\n Upgrader? upgrader,\n required this.builder,\n }) : super(upgrader ?? Upgrader.sharedInstance as Upgrader, key: key);\n\n /// Defines how the widget will be built. Allows the implementation of custom\n /// widgets.\n final UpgradeWidgetBuilder builder;\n\n /// Describes the part of the user interface represented by this widget.\n @override\n Widget build(BuildContext context, UpgradeBaseState state) {\n if (upgrader.debugLogging) {\n log('UpgradeWidget: build UpgradeWidget');\n }\n\n return FutureBuilder(\n future: state.initialized,\n builder: (BuildContext context, AsyncSnapshot<bool> processed) {\n if (processed.connectionState == ConnectionState.done &&\n processed.data != null &&\n processed.data!) {\n if (upgrader.shouldDisplayUpgrade()) {\n if (upgrader.debugLogging) {\n log('UpgradeWidget: will call builder');\n }\n return builder.call(context, upgrader);\n }\n }\n\n return const SizedBox.shrink();\n },\n );\n }\n}\nHere's a quick overview of the code you just added:
\nUpgradeWidget is a wrapper widget that implements the same basic behavior that UpgradeCard and UpgradeAlert share. It extends UpgradeBase and does basic checks when the customized build is executed. This widget will allow you to wrap any widget and display information about updating the app if needed.UpgradeWidget receives an optional Upgrader implementation but also has the default one. This is the way that both UpgradeCard and UpgradeAlert work. Making the custom widget use the same principles allows you to keep interoperability between your custom widget and the library's API.UpgradeWidgetBuilder is an alias for the builder function used to render your content widget. It has Upgrader as a parameter because that will give you access to the information required for building your custom widget. You'll see more about this next.Now that you have set up a reusable UpgradeWidget, open lib/core/widgets/dwi_appbar.dart and copy this code at the bottom of the file:
class _UpdateButton extends StatelessWidget {\n const _UpdateButton({\n Key? key,\n }) : super(key: key);\n\n @override\n Widget build(BuildContext context) {\n return UpgradeWidget(\n upgrader: Upgrader(\n //! This is a bit of a hack to allow the alert dialog to be shown\n //! repeatedly.\n durationUntilAlertAgain: const Duration(milliseconds: 500),\n showReleaseNotes: false,\n showIgnore: false,\n ),\n builder: (context, upgrader) => CircleAvatar(\n child: IconButton(\n onPressed: () {\n upgrader.checkVersion(context: context);\n },\n icon: const Icon(Icons.upload),\n ),\n ),\n );\n }\n}\n_UpdateButton is a convenience private widget that will allow you to set the behavior for your custom UpgradeWidget. In this case, the idea is to showcase upgrader's alert dialog when the IconButton is tapped. This can be accomplished by calling checkVersion and passing the context as a parameter; the plugin will take over when the function is called and a new UpgradeAlert should be displayed.
For better readability the flags showReleaseNotes and showIgnore are set to false since both elements take too much space in the UI, and since the DWI users are familiar with simple user experience, then you can skip showing them for now.
One last caveat is that whenever the user taps Later in UpgradeAlert, the library stores a timestamp to avoid showing the dialog too often or at undesired times. It will only reshow the dialog once some time has passed (the default is 3 days).
For DWI you'll need to bypass this feature and show the dialog everytime the user taps on the update IconButton. To accommplish this you are overriding the default durationUntilAlertAgain with a Duration of 500 milliseconds. This way, the library will mark the dialog as ready as soon the user closes the dialog.
\n\nThis is a hacky solution because it wouldn't be needed if the library trusted you to display the alert dialog at any point you wanted. Unfortunately, at the time of writing this tutorial,
\nupgraderdoes not support this kind of behavior out of the box.
Now add _UpdateButton(), to actions in line 21. Also make sure you add the corresponding imports for the library at the top of the file:
import 'package:dwi/core/widgets/widgets.dart';\nimport 'package:upgrader/upgrader.dart';\nBuild and run, you should see the following:
\nAnother great feature of upgrader is to enforce a minimum app version simply by adding predefined text to the description in the app stores or by defining the minimum app version inside your Upgrader configuration like so:
Upgrader(\n minAppVersion: '3.0.0',\n),\nIf you are looking to use app store descriptions then keep in mind the following formats:
\n[Minimum supported app version: 1.2.3][:mav: 1.2.3]Using that text will define the minimum app version as 1.2.3; which means that earlier versions of this app will be forced to update to the latest version available.
\nAn important limit of upgrader is that the default behavior of upgrader leverages the current App Store and Play Store listings of your app, this means that:
To solve this, upgrader has support for working with AppCast which is:
\n\nan RSS feed with one channel that has a collection of items that each describe one app version. The appcast will describe each app version and will provide the latest app version to upgrader that indicates when an upgrade should be recommended.
\n
It is based on the Sparkle framework by Andy Matuschak. You can read the Sparkle documentation here. It is a widely used standard that lists all the versions of your app with an XML format. Here's an example of how an appcast file could look like taken from Sparkle's documentation:
\n<rss xmlns:sparkle="http://www.andymatuschak.org/xml-namespaces/sparkle" xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">\n <channel>\n <title>Sparkle Test App Changelog</title>\n <link>http://sparkle-project.org/files/sparkletestcast.xml</link>\n <description>Most recent changes with links to updates.</description>\n <language>en</language>\n <item>\n <title>Version 2.0</title>\n <link>https://sparkle-project.org</link>\n <sparkle:version>2.0</sparkle:version>\n <description>\n <![CDATA[ <ul> <li>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</li> <li>Suspendisse sed felis ac ante ultrices rhoncus. Etiam quis elit vel nibh placerat facilisis in id leo.</li> <li>Vestibulum nec tortor odio, nec malesuada libero. Cras vel convallis nunc.</li> <li>Suspendisse tristique massa eget velit consequat tincidunt. Praesent sodales hendrerit pretium.</li> </ul> ]]>\n </description>\n <pubDate>Sat, 26 Jul 2014 15:20:11 +0000</pubDate>\n <enclosure url="https://sparkle-project.org/files/Sparkle%20Test%20App.zip" length="107758" type="application/octet-stream" sparkle:edSignature="7cLALFUHSwvEJWSkV8aMreoBe4fhRa4FncC5NoThKxwThL6FDR7hTiPJh1fo2uagnPogisnQsgFgq6mGkt2RBw=="/>\n </item>\n </channel>\n</rss>\nThis file should be hosted in a server accessible to anyone that uses the app. It also can be autogenerated during the release process, or you can also manually update it after a release is available on the stores.
\nUsing upgrader with an AppCast is relatively simple as well. Here's an example taken from the library's documentation:
import 'package:flutter/material.dart';\nimport 'package:upgrader/upgrader.dart';\n\nvoid main() => runApp(const MyApp());\n\nclass MyApp extends StatelessWidget {\n const MyApp({\n Key key,\n }) : super(key: key);\n\n @override\n Widget build(BuildContext context) {\n final appcastURL =\n 'https://raw.githubusercontent.com/larryaasen/upgrader/master/test/testappcast.xml';\n final appcastConfig = AppcastConfiguration(url: appcastURL, supportedOS: ['android', 'ios']);\n\n return MaterialApp(\n title: 'Upgrader Example',\n home: Scaffold(\n appBar: AppBar(\n title: Text('Upgrader Example'),\n ),\n body: UpgradeAlert(\n Upgrader(appcastConfig: appcastConfig),\n child: Center(child: Text('Checking...')),\n )),\n );\n }\n}\nGreat work, now you know exactly how to keep your user's running the latest version of your app and also the main gotchas that you might find along the way.
\nRemember that you can view a complete list of all the changes needed in this PR of Days Without Incidents.
\nIf you are wondering what's the best data storage solution for your Flutter app, check out this tutorial by Onuoha Ifeanyi in which a comparison is made between different databases.
\nLooking for adaptive app guidance? Damilare Jolayemi has great insights in this tutorial
\nI hope you enjoyed this tutorial, if you did, sharing it with others is much appreciated. And if you have any questions or comments, leave them down below and I'll be happy to chat.
", "url": "https://codingale.dev/blog/2022-11-25-how-to-encourage-app-updates-flutter", "title": "How to encourage app updates with Flutter", "summary": "One big advantage when creating mobile apps is to offer new content and features to your users. This means that you will have to release new versions of your app with a higher cadence and, in turn, have many versions of your app out there, some even broken. This is a problem for app development and there's a great Flutter plugin that helps you solve it: `upgrader`.", "date_modified": "2022-11-25T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2022-06-01-bloc-update-getting-started", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2022-06-01-bloc-update-getting-started", "title": "Bloc 8.0 Tutorial for Flutter: Getting Started", "summary": "Learn how to build a Wordle clone app in Flutter using one of the most robust state management libraries: Bloc 8.0.", "date_modified": "2022-06-01T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2022-01-26-creating-custom-gestures-in-flutter", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2022-01-26-creating-custom-gestures-in-flutter", "title": "Creating Custom Gestures in Flutter", "summary": "Learn how to add custom gestures in your Flutter app by working on a fun lock-picking app.", "date_modified": "2022-01-26T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2021-08-04-microinteractions-with-animatedswitcher", "content_html": "Content is propietary belonging to kodeco.com
", "url": "https://codingale.dev/blog/2021-08-04-microinteractions-with-animatedswitcher", "title": "Adding Microinteractions With AnimatedSwitcher", "summary": "Micro-interactions and animations are key factors in people choosing and continuing to use apps. Thus, adding micro-interactions is important for the success of your app. It hasn't always been easy, but now with AnimatedSwitcher, you can add a lot of interactivity to your app without investing too much effort.", "date_modified": "2021-08-04T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } }, { "id": "https://codingale.dev/blog/2021-08-03-hola-mundo", "content_html": "¡Hola! Desde siempre me ha gustado la escritura, recuerdo que el mundo de las palabras siempre me ha llamado la atención, me ha enamorado y ahora llegó el tiempo de dejarme llevar por las letras y compartir mi conocimiento (y también mi ignorancia) con el mundo entero a través de internet. Éste blog estará lleno de opiniones personales, experiencias vividas y recomendaciones desde mi perspectiva, así que ya sabes, es completamente subjetivo.
\nSe trata de un blog multitemático, que aborda temas como tecnología, opinión, programación, entre otros. Mi única intención con este blog es compartir conocimiento, experiencias, puntos de vista y recomendaciones desde mi perspectiva con toda persona interesada en conocerlos.
\nNo tengo planeado una periodicidad para las publicaciones, pero tengo la intención de publicar al menos un post por mes.
\nUn poco de ambos. Actualmente realizo artículos de aprendizaje para kodeco.com y otros foros de contenido los cuáles son siempre en inglés; sin embargo, publicaré posts en español o inglés en mi blog personal (el que lees ahora) simplemente porque me gusta escribir.
", "url": "https://codingale.dev/blog/2021-08-03-hola-mundo", "title": "¡Hola Mundo!", "summary": "¡Hola! Desde siempre me ha gustado la escritura, recuerdo que el mundo de las palabras siempre me ha llamado la atención, me ha enamorado y ahora llegó el tiempo de dejarme llevar por las letras.", "date_modified": "2021-08-03T00:00:00.000Z", "author": { "name": "Alejandro Ulate" } } ] }