Bearbeiten von „Exhibition-Workflow“

= Links =
* [[Exhibition]]

= Workflow =
We use the module "Users" as example
* Create a metadata description: lib/meta/users_meta.dart
<syntaxhighlight lang="dart">
import 'module_meta_data.dart';

class UserMeta extends ModuleMetaData  {
  static UserMeta instance = UserMeta.internal();
  UserMeta.internal() : super('Users',
    [
      PropertyMetaData('id', DataType.reference, ':primary:', 'combo'),
      PropertyMetaData('name', DataType.string, ':notnull:', '', size: 64),
      PropertyMetaData('displayName', DataType.string, ':unique:notnull:', '', size: 32),
      PropertyMetaData('email', DataType.string, ':unique:notnull:', '', size: 255),
      PropertyMetaData('role', DataType.reference, ':notnull:', ''),
      PropertyMetaData('created', DataType.datetime, '', ''),
      PropertyMetaData('createdBy', DataType.string, '', '', size: 32),
      PropertyMetaData('changed', DataType.datetime, '', ''),
      PropertyMetaData('changedBy', DataType.string, '', '', size: 32),
    ],
    tableName: 'loginusers',
  );
  factory UserMeta(){
    return instance;
  }
}
</syntaxhighlight>
* Create some source files: (for example: the module "Users")
<syntaxhighlight lang="dart">
# precondition: the current directory is the base folder of the dev-app.
mkdir -p lib/meta/users
# The following call works without meta data. It works without recreation of the tool:
./Meta show-modules Users >lib/meta/modules.dart
# Now we need a new instance of the meta_tool (to realize the meta data changes):
./ReCreateMetaTool
./Meta show-data >lib/page/users/user_data.dar
# Show the SQL definition:
./Meta show-table Users
</syntaxhighlight>
* Create all source files:
<syntaxhighlight lang="dart">
# precondition: the current directory is the base folder of the dev-app.
# The following call works without meta data. It works without recreation of the tool:
./Meta update-modules-list
# Now we need a new instance of the ./Meta (to realize the meta data changes):
./ReCreateMetaTool
./Meta update-modules-files
./Meta update-sql
</syntaxhighlight>

= Important Locations =
* Application menu page: lib/setting/drawer_xxx.dart: Definition route + Icon
* Starting route: lib/page/start_page.dart: globalData.navigate(context, '/Users/list');

= Typical Adaptions =
* all *_custom.dart:
** buildFrame(): formular elements (widgets)
** build(): "rows = attendedPage.getRows(...)": column list, column adaptions (onColumnOfRecord) 
** requestRecords(): parameters of the database query

* list_user_custom.dart:
** buildFrame(): table headers

= Handling of a Combobox =
* all *_custom.dart:
<pre>
buildFrame(){
...
  comboRolesFromBackend(attendedPage: attendedPage, onDone: () => setState(() => 1));
  final itemsRoles =
        comboRoles(i18n.trDyn(GlobalTranslations.comboboxSelect), attendedPage);
...
FormItem(
  DropdownButtonFormField<int>(
    value: itemsRoles == null || itemsRoles.length == 1 ? 0 : _fieldData.role,
    items: itemsRoles,
    isExpanded: true,
    decoration: InputDecoration(labelText: i18n.tr('Role')),
    onChanged: (value) => _fieldData.role = value ?? 0,
    ),
  weight: 6),
...
}
class _FieldData {
...
  int role;
...
}
</pre>

= I18N =
== Coding ==
<pre>
// in each source file using I18N:
final i18n = I18N();
...
  // Usage in any expression:
  // Simple without parameters:
  final msg = i18n.tr('Please wait');
  // Singular/plural case:
  final msg = i18n.ntr('Hi user', 'Hi users', countUsers);
  // Dynamic key (not a string constant):
  comboUsers(i18n.trDyn(GlobalTranslations.comboboxSelect), ...);
  // String with placeholder(s):
  rc = i18n.trArgs('Not a Date: {0}', '!global', [input]);
</pre>
== Workflow ==
=== For the First Time ===
<pre>
cd $BASE_PROJECT
mkdir -p i18n
tools/i18n_text_parser parse lib i18n
vi i18n/project.i18n.yaml
# Adapt the data in the yaml file
# Than run again:
tools/i18n_text_parser parse lib i18n
tools/i18n_text_parser msg-init i18n '!globals' de_DE
</pre>
* In the directory i18n will be created some *.pot files (one for each module)
* Translate them with babel

= Android Configuration =
* android/app/src/debug/AndroidManifest.xml + android/app/src/profile/AndroidManifest.xml:
<pre>
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
</manifest>
</pre>
* android/app/src/main/AndroidManifest.xml:
<pre>
...
    package="de.hamatoma.exhibition">
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.CAMERA" />

   <application>
...
</pre>
* android/app/build.gradle
<pre>
    defaultConfig {
...
      multiDexEnabled true
    }
...
</pre>

=== After the First Time ===
<pre>
tools/i18n_text_parser parse lib i18n
</pre>