Skip to content

How to update

Jahir Fiquitiva edited this page Aug 24, 2023 · 53 revisions

How to update?

Updating is usually easy, but some times, it requires a few extra steps.

First

Upgrade the Blueprint library version.

To do it, go to the buildSrc/src/main/java/Versions.kt file.

Then look for these lines:

const val blueprint = "x.x.x"

Update the version code with the latest, which currently is: (ignore the v character)

Next

The following steps are to apply some more specific or complex changes that are required every now and then to keep the apps completely up to date.

This might be a bit overwhelming at first, but once you get used to it, it will become easier.

The first thing you need to do, is check what version of Blueprint are you currently using and which one is the latest.

Let's say you are currently at version 2.3.0 and the latest is 2.3.7.

You must go version by version like: 2.3.1, then 2.3.2, then 2.3.3, and so forth, until you get to 2.3.7.

If you don't see a version listed below, for example 2.3.1, then it means no additional changes are required for that specific version, and you can move on with the next one, which would be 2.3.2.

Check below for the additional required changes. They usually have a link to a commit or a comparison, that looks like the following:



Some things to note:

  • Red means code that was removed.
  • Green means code that was added.
  • Always, the whole line will be highlighted, but it doesn't mean the whole line was removed/added. And you might find small parts of the code in a line being highlighted with a darker color.

If you still need help, you can always join the discord server and ask any questions you have or ask for help.


Additional required changes:

Whenever a new release is available and it requires extra changes for your setup, this is the section where they will be mentioned.

v2.3.7

Check and apply the changes in this commit

v2.3.6

Check and apply the changes in this commit

v2.3.5

Check and apply the changes in this commit

v2.3.4

Check and apply the changes in this commit

v2.3.0

Apply the changes from this commit.

v2.2.8

Check and apply the changes in this commit

v2.2.6

Check and apply the changes in this commit

v2.2.5

Check and apply the changes in this commit

v2.2.4

Check and apply the changes in this commit

v2.2.3

Check and apply the changes in this commit

v 2.2.2

Check and apply the changes in this commit

v2.1.8

Check and apply the changes in this commit

v2.1.5

Check and apply the changes in this commit

v2.1.4

Check and apply the changes in this commit

v2.1.1

Check and apply the changes in this commit

v2.1.0

Add <item>oneplus</item> to supported_launchers.xml

v2.0.6

v2.0.2

If you want to customize your app even more that you already can, you might want to apply the changes in this commit

v2.0.0

Dashboard has been rewritten from scratch and many things have changed. It's probably easier to start from scratch. Save your assets, icons and xmls files. Many of them will work fine.

v1.4.9 and v1.5.0

Check and apply the changes in this commit and this commit

v1.4.2

Check and apply the changes in this commit

v1.4 and newer

Check and apply the changes in this commit.

Then delete the folder .idea/libraries/ and all build folders, and then restart Android Studio using the Invalidate Caches and Restart option.

v1.3.0

Check the changes in this commit

v1.2.9

Provide links for your Privacy Policy and/or Terms and Conditions in order to avoid issues with Play Store. Generate them here.

v1.2.8

Update the app/build.gradle, launchers.xml and dependencies.gradle files.

v1.2.7

Update your AndroidManifest.xml as done in this commit.

v1.2.6

Update the app/build.gradle and dependencies.gradle files.

v1.2.4

Easy as doing the same changes in the files that this commit shows.

v1.2.3

Easy as doing the same changes in the files that this commit shows.

v1.2.0

Easy as doing the same changes in the files that this commit shows.

v1.1.8

Easy as doing the same changes in the files that this commit shows.

v 1.1.5

Easy as doing the same changes in the files that this commit shows. Basically just some minor version updates 😉

v1.1.4

Easy as doing the same changes in the files that this commit shows. Basically just some minor version updates.

v1.1.3

  1. There's a new launchers.xml file where you can remove the launchers you don't want to show in the "Apply" section.
  2. There's a new bool config in blueprint_configs.xml in case you want to hide the "General Information" in "Home" section.

v1.1.1

  1. Update your build.gradle to match the new app/build.gradle file
  2. Update the proguard files:

v1.0.4

Update the proguard-rules.pro file.

Clone this wiki locally