Skip to content

Tiny DB

Non-Visible component
Category Requires Version
Storage API 21, Android 5.0 Lollipop 2

Overview

TinyDB is a non-visible component that stores data for an app.

Apps created with Kodular are initialized each time they run: If an app sets the value of a variable and the user then quits the app, the value of that variable will not be remembered the next time the app is run. In contrast, TinyDB is a _ persistent _ data store for the app, that is, the data stored there will be available each time the app is run. An example might be a game that saves the high score and retrieves it each time the game is played.

Data items are strings stored under tags . To store a data item, you specify the tag it should be stored under. Subsequently, you can retrieve the data that was stored under a given tag.

There is only one data store per app. Even if you have multiple TinyDB components, they will use the same data store. To get the effect of separate stores, use different keys. Also each app has its own data store. You cannot use TinyDB to pass data between two different apps on the phone, although you can use TinyDb to shares data between the different screens of a multi-screen app.

When you are developing apps using the AI Companion, all the apps using that companion will share the same TinyDb. That sharing will disappear once the apps are packaged. But, during development, you should be careful to clear the TinyDb each time you start working on a new app.

Methods

Clear All

Clear the entire data store

Clear Tag

Clear the entry with the given tag

Params
tag Text

Get Entries

Returns: Dictionary

Retrieves all data entries of TinyDB in form of Dictionaries

Get Tags

Returns: Any

Return a list of all the tags in the data store

Get Value

Returns: Any

Retrieve the value stored under the given tag. If there's no such tag, then return valueIfTagNotThere.

Params
tag Text
value If Tag Not There Any

Store Value

Store the given value under the given tag. The storage persists on thephone when the app is restarted.

Params
tag Text
value To Store Any

Properties

Namespace

Text Default: TinyDB1 ➖ Read Write - Designer Blocks

Namespace for storing data.


Last update: November 9, 2022