Android RIA - Magic Software DEVNET Japan

Android でのMagic RIA
はじめの 一 歩

目 次
目 的 と 前 提 条 件
Hello Magic プログラム
Android RIAプログラムの 特 性
カスタムモジュールの 作 成
付 録

目 的 と 前 提 条 件
目 的 : Magic xpa 2.2 を 使 った、Android RIA プログラム 開 発 の 基 本
を 理 解 することが 目 的 です。
環 境 的 な 前 提 条 件 としては:
Windows PC 上 に、Magic xpa 2.2 Enterprise Studio (あるいは
体 験 版 ) をインストールしてあること。
Android デバイスを 所 有 していて、テストに 使 えること。
※ Android SDKのエミュレータでも 可 能 です。
Magic xpa Studio のあるPCへ、Androidからネットワーク 接 続 で
きること。
読 者 のスキルの 前 提 条 件 としては:
Magic xpa 2.2 (あるいは uniPaaS V1Plus) で、Windows RIA シ
ステムを 作 成 した 経 験 があること。
Androidアプリの 開 発 経 験 は 前 提 としません。( 経 験 あればもっと
良 い)
※ サポートしているWindowsバージョン、Androidバージョン 等 については、
弊 社 HPを 参 照 してください。
http://devnet.magicsoftware.co.jp/magicxpa/magicxpa2/dbmsmagicxpa2/

本 資 料 について
本 書 は、 製 品 添 付 「モバイルRIA 開 発 者 ガイド」をもとに、 基 本
的 なことだけを 抜 き 出 し、ステップバイステップで 実 行 できるよう
に 編 集 したものです。
「モバイルRIA 開 発 者 ガイド」は、モバイル RIA (Android, iOS
共 に) に 固 有 な 技 術 情 報 を 包 括 的 にまとめてあり、 本 書 に 掲 載
されていない 詳 しい 情 報 も 多 くありますので、モバイルRIA 開 発
に 先 立 ち、そちらもご 一 読 ください。

Hello Magic プログラム
何 はともあれ、まずは 最 も 簡 単 なプログラムを 例 に
取 って、Android RIAを 動 かしてみましょう

PC 側 準 備
Android デバイス 上 で 実 行 する 前 に、まずPC 上 での 準 備 をしておき
ましょう。
1. Magic xpa Enterprise Studio をインストールします( 説 明 省 略 )
2. Pervasive PSQL をインストールします ( 説 明 省 略 )
3. RIAサンプルプログラム Hello Magic を 作 成 します。
4. Windows RIAで 動 作 確 認 します。

Hello Magic プログラム 作 成
Android RIA アプリケーションも、Windows RIAと 同 じようにして 作
成 します。
1. Hello プロジェクト 作 成
2. Hello Magic プログラム 作 成 ( 公 開 名 hello)
変 数 表 示 のみのタスク
※ 「 外 部 」 にチェックを 入 れるのを 忘 れないように

フォームエディッタ

F7 実 行 (Windows RIA)で 確 認
Studio プログラムリポジトリから、F7 でテ
スト 実 行 してみます。
Magicが 正 しくインストールされていれば、
問 題 なく 実 行 されるはずです。
ここで 何 らかのエラーが 出 るようであれば、
Android に 進 む 前 に、エラーを 解 決 してお
いてください。
F7 実 行

Android 上 で 実 行 してみましょう
Windows RIAで 実 行 を 確 認 したら、いよいよ Android 上 で 実 行
してみましょう。
手 順 は、 大 きく 分 けて、 以 下 のようになります:
1. Androidモジュールをインストールします。
2. DevProps.txt を 編 集 、Webサーバ 上 に 置 きます。
3. RIAサーバを 待 機 状 態 にしておきます。
4. Androidモジュールを 起 動 します。
→ これで 動 くはず!!

インストールに 先 立 って 準 備
Androidのデフォルトの 設 定 では、Google Play からダウンロー
ドしたアプリしかインストールできないようになっています。(エ
ラーが 出 ます)
Magic のRIAモジュールをインストールするには、この 制 限 を 解
除 しておく 必 要 があります。
※ インストール 時 にだけ 解 除 して、インストール 後 には 元 に 戻
して 良 いです。

アプリインストール 制 限 を 解 除 するには
Android の「 設 定 」 → セキュリティ
→ 提 供 元 不 明 のアプリ にチェック
を 入 れます。
これで 解 除 されます。
制 限 をもとに 戻 すには、このチェッ
クを 外 します。

Android モジュールをインストール
Magic xpa の Android RIA 用 のモジュールは、
RIAModules¥Android¥ MyApp.apk にあります。

Androidモジュールをインストール
1. アプリ MyApp.apk をAndroid デバイスにコピーします。
※ ファイルをコピーするには、 次 のいずれかの 方 法 によります。
Webサーバからダウンロード
(IISのMIME 設 定 必 要 → 付 録 参 照 )
マイクロSD
USB 接 続
メール
クラウドファイル 共 有 サービス
2. MyApp.apk をダブルクリックします。
→ モジュールがインストールされます。

MyApp.apk の 注 意 事 項
添 付 MyApp.apk は、 開 発 時 動 作 確 認 用 の 暫 定 モジュールで
す。
実 運 用 時 には、MyApp.apk は 使 わず、アプリケーション 用 にカ
スタマイズしたモジュールをビルドして 利 用 します。
カスタマイズの 項 目 と 方 法 → 別 冊 で 説 明 。

DevProps.txtファイルを 編 集 します
DevProps.txtは、 実 行 しようとするMobile RIA アプリケーション
について、サーバ 側 情 報 を 定 義 したファイルです。
C:¥InetPub¥wwwroot¥DevProps.txt に、 以 下 のような 内 容 で
ファイルを 作 成 します。
※ サーバ 構 成 /プロジェクト 名 / 公 開 プログラム 名 に 合 わせて、 設 定
を 変 更 してください。

( 補 足 ) DevProps.txt という 名 前 について
DevProps.txt という 名 前 は、 任 意 に 変 更 して 構 いません。
以 下 では、DevProps.txt という 名 前 を 前 提 に 説 明 します。 異
なる 名 前 にした 場 合 には、それに 応 じて 変 更 してください。
拡 張 子 は .txt のままにしておくのが 無 難 です。
※ 拡 張 子 を 変 えると、IISのセキュリティ 機 能
に 引 っかかることがあります。

DevProps.txt を 確 認 します
Webサーバでアクセスできることを 確 認 してください。
例 : ファイルが
C:¥InetPub¥wwwroot¥DevProps.txt
に 置 いてあれば、URL は
http://MGSTUDIO/DevProps.txt
となります。
Webブラウザから、このURLを 指 定 して、DevProps.txt の 内
容 が 正 しく 表 示 されることを 確 認 します。
※ この URL は、RIAクライアント 起 動 時 にアクセスします

DevProp.txtの 確 認 の 補 足
DevProps.txt は、PC 上 のWebブラウザだけでなく、Androidデ
バイス 上 でのWebブラウザからも 行 なってみてください。
( 経 験 上 ) Androidでは、LAN 上 のホスト 名 解 決 ができないこと
があるようです。その 場 合 には、「サーバが 見 つからない」という
ようなエラーとなります。
もし、Windows PC 上 のWebブラウザではOKなのに、Android
のWebブラウザでダメならば、Windows PCのホスト 名
(MGSTUDIO) を 数 字 のIPアドレス ( 例 :192.168.1.8 とか。
ネットワーク 環 境 により 違 います)に 変 えてみてください。
※ その 場 合 には、DevProps.txt 内 のホスト 名 も、IPアドレスに 変
えてください。

メインプログラム 画 面 の 表 示 を 抑 制 します
サーバを 待 機 状 態 にしておく
前 に、 一 点 、プロジェクトを 修
正 します。
メインプログラム → タスク 特
性 → インターフェース タブ →
ウィンドウ 表 示 を No に 設 定 し
ます。
これにより、メインプログラム
の 画 面 が 表 示 されないように
なります。
参 考 : メインプログラムの 画 面 を 非 表 示 にする 理 由
は、 付 録 「メインプログラムのウィンドウ 表 示 」を 参 照
してください。

サーバを 待 機 状 態 にしておきます
「デバッグ → プロジェクトの 実 行 (J)」で
待 機 状 態 にします→ タイトルが
Executing… になります。

MyApp 起 動
Android 上 で、MyApp をタップし
ます。
アプリケーション 情 報 を 入 力 する
ダイアログが 出 るので、
DevProps.txt のURLを 指 定 しま
す。
成 功 !!(のはず)
‣ このURLの 情 報 は 記 憶 されるので、 最 初 に
一 度 入 力 したら、 二 回 目 以 降 は 出 て 来 ま
せん。
‣ ホスト 名 が 正 しく 認 識 されない 場 合 には、
IPアドレスを 指 定 してください。

MyApp を 終 了 するには・・・
終 了 するには 「 戻 る」ボタンを 押 します。

気 になる 背 景 色 を 変 更 しましょう
背 景 が 黒 色 で 表 示 されている。 変 えたい・・・
← フォームの 色 1 が、Windows システム 色 のためです。
※ Windows システム 色 の 場 合 、Android のデフォルトの 動 作 (= 黒 色 ) となります。

色 定 義 ファイルを 変 更 します
clr_rnt.jpnをコピーして、このアプリケーション 専 用 の 色 設 定 ファ
イルにしましょう。
プロジェクトのフォルダの 下 に、ENVフォルダを 作 成 します。
clr_rnt.jpn を、プロジェクトのENVフォルダにコピーして、
clr_hello.jpn に 改 名 します。
このファイルを、アプリケーション 特 性 → 外 部 参 照 ファイル
タブ → アプリケーション 基 本 色 定 義 ファイル に 設 定 します。
ズームして、アプリケーション 用 基 本 色 テーブルを 表 示 しま
す。
色 1 の 背 景 で、システム 色 の 設 定 を 外 します。

再 度 実 行 して 確 認 しましょう
再 度 実 行 してみます。
→ 今 度 は 背 景 が 白 色 になったはずです。

Android RIAの 特 性 を 理 解 しましょう

Android RIAの 特 性
Android のような、MobileデバイスとWindows PCを 比 べると、
デバイスのハードウェア 特 性 の 違 い、OS の 違 い、ユーザ・イン
ターフェース (UI) の 基 本 動 作 やコンポーネントなどが 大 きく 違
います。
このため、Windows RIAの 開 発 と 同 じ 感 覚 で 作 成 していると、
Android デバイス 上 で 実 行 すると、 非 常 に 使 いにくいものになっ
てしまう 可 能 性 があります。
アプリケーションを 開 発 するに 先 立 って、Android デバイスの 動
作 の 特 徴 をよく 理 解 して、アプリケーションを 設 計 しましょう。

Android RIAアプリのフォーム 表 示 について
Mobile デバイス (Android、iOSとも) 上 のアプリの 一 般 的 な 特
性 として、Windows アプリとはUIがかなり 異 なります。
( 基 本 的 に) すべてフルスクリーン 画 面 → モーダル
タスクの 終 了 = 「 戻 る」ボタン (ESCキーに 相 当 )
HOMEキーでは 終 了 しない ( 背 後 で 動 作 し 続 けている)

テスト 用 親 子 タスク
※ 簡 単 な 親 子 タスクを 作 って、 実 際 に 確 認 してみましょう。
ボタンで 子 タスクを 呼 び 出 すだけの、 簡 単 な 親 子 タスクを 作 りま
す。

Windows RIAでは・・・
親 タスク、 子 タスクの 画 面 が、フォームエディタで 定 義 された
通 りの 大 きさと 位 置 で 表 示 されます。

Android RIAでは・・・
DevProps.txt を 編 集 し、 公 開 名 を、 新 たに 作 成 した 親 子 タスクに 変 更
します。
実 行 すると、 子 タスクはフルスクリーンで 表 示 され、 親 タスクのフォー
ム 全 体 を 覆 うように 表 示 されます。
APP
起 動
戻 る
ボタン
フルスクリーン
で 表 示 される。
コール
戻 る
ボタン
子 タスクが 親
タスクのフォー
ム 全 体 を 覆 う
ように 表 示 さ
れる。
アプリが 終 了
する。

「ホーム」ボタンの 動 作 は
Android には、「 戻 る」ボタンの 他 に、「ホーム」ボタンがあります。
どちらを 押 しても、アプリの 画 面 が 消 えるので、 一 見 、どちらでも
良 さそうに 思 えますが、 動 作 に 大 きな 違 いがあります。
ホームボタンでは、アプリは 終 わりません。
ホームボタンは、アプリの 画 面 を 隠 すだけ。Windowsの「 最
小 化 」みたいなものです。
再 度 アプリを 起 動 すると、 直 前 の 画 面 が 復 元 されます。

APP
起 動
コール
ホームボタン
再 度 APP 起 動
背 後 でまだ 動 いている。
( 終 了 していない)
ホームボタン
を 押 す

正 しいアプリの 終 わり 方 は
最 初 のタスクで、「 戻 る」ボタンを 押 す。
最 初 のタスクで、「クローズ(C)」 イベントを 発 行 する。
「 終 了 (X)」イベントを 発 行 する。
※ 「 終 了 」イベントではありません。

キーボード 入 力 は
Androidデバイスでは、 基 本 的 にハードウェアキーボードやマウスがついてい
ません。
次 のようなケースではハードウェアキーボードを 使 えますが、 一 般 的 には 使 え
ないという 前 提 でアプリケーションを 設 計 する 必 要 があります。
タブレット 型 のデバイスには、ハードウェアキーボードが 付 いているものも
あります。
Bluetooth キーボードをサポートしているものもあります。
データ 入 力 は、 次 のものを 使 って 行 います。
指 でのタップ (マウス 代 わり)
ソフトキーボード
ハードウェアキーボードがないので、Windows RIAで 当 たり 前 にできていたこ
とができなくなることが 多 々あります。
「 何 ができて、 何 ができないか」は、ソフトキーボードの 機 能 に 大 きく 依 存 しま
す。
Androidの 場 合 、ソフトキーボードは 各 社 各 様 ですので、 利 用 予 定 のデバイス
に 付 属 のソフトキーボードの 仕 様 も 把 握 しておく 必 要 があります。

ソフトキーボード 例

ソフトキーボードでの 制 約 は
※ ソフトキーボードは 各 社 各 様 ですが、 一 般 的
な 制 約 事 項 を 挙 げると・・・
Tab キーがない → 指 でタップして 移 動
Ctrl キーがない →
モード 変 更 (Ctrl+M, Ctrl+E、Ctrl+Q) で
きない
コピペ (Ctrl+C、Ctrl+P、Ctrl+V)できない
ファンクションキーがない
ズーム (F5)、キャンセル (Ctrl+F2) 不 可
矢 印 キーがない (↑、↓、→、←)
カーソル 移 動 は 指 でタップするしかない
新 規 行 作 成 できない

キーボードの 代 わりの 手 段 を 提 供 しましょう
これらの 制 限 に 対 応 する 手 段 を 提 供 す
るようにしましょう。
ボタンの 追 加 : 行 作 成 、 行 削 除 、タ
スクモード 切 り 替 えなどをボタンに 割
り 当 てます。
メニュー: メニューに 内 部 イベントを
設 定 します。
プログラムロジック: 行 の 最 後 の 項
目 に 入 力 がされれば、「 次 行 」イベン
トを 発 行 する、などのロジックを 組 込
みます。

フォームやコントロールの 特 性 を 理 解 しましょう
Magic Studio のフォームエディッタは、Windows のGUI 部 品 によって
表 示 されます。
一 方 、Androidデバイス 上 で 実 行 する 際 は、 Android のGUI 部 品 に
よって 表 示 されます。
したがって、フォームエディタ 上 と 実 際 の 画 面 で 見 え 方 が 異 なります。
アプリのフォーム 設 計 を 始 める 前 に、フォームエディタと 実 際 の 表 示 と
の 違 いについて、よく 把 握 しておきましょう。
主 な 確 認 項 目 は 次 のようなものです:
フォームサイズ
文 字 の 大 きさ
コントロールの 形 状 (エディット、プッシュボタン、コンボボックス、
チェックボックス) とサイズ
Windowsシステム 色 の 効 果
Android 独 自 のフォント

フォームサイズ
iOS の 場 合 には、iPhone、iPad、iPad mini で、デバイスの 種
類 はそう 多 くはありません。
Androidの 場 合 には、 非 常 に 多 種 多 様 なデバイスがあり、 画 面
解 像 度 も 全 部 違 います。
「すべてのデバイスに 対 応 したフォーム」を 設 計 するのは、 事 実
上 不 可 能 です。
利 用 予 定 の 機 種 を 選 定 し、それを 前 提 としたフォーム 設 計 を 行
います。

フォームサイズの 測 定
フォーム 設 計 の 第 一 歩 は、フォームサイズの 把 握 です。
大 きすぎても、 左 右 ・ 上 下 にスクロールして 見 ることはでき
ますが、 使 用 感 は 悪 くなります(※)。
Magicのフォームサイズ 自 動 調 整 機 能 は 有 効 で、 多 少 の
画 面 サイズの 違 いは、これで 吸 収 可 能 です。
しかし、あまり 大 きく 違 うと 画 面 が 間 延 びしたり、 重 なってご
ちゃごちゃ 詰 め 込 みすぎになったりしてしまいます。
※ スクロールについての 注 意 事 項 があります → 「フォームのスクロー
ルの 基 本 」 以 下 参 照 。

自 動 調 整 がうまく 行 かず、ご
ちゃごちゃしすぎの 画 面
まのびしすぎた 画 面

画 面 サイズを 測 りましょう
寸 法 単 位 は、「C=センチメートル」にするのが、 一 番 簡 単 なよ
うです。
実 際 のデバイスの 画 面 サイズを cm で 測 り、フォームのサイ
ズとします。

理 屈 通 りにはいかない・・・
現 実 の Android デバイスで 表 示 させてみ
ると・・・
寸 法 単 位 を「C=センチメートル」として
も、 指 定 した 通 りのサイズに 表 示 され
るとは 限 りません。
更 に、 縦 と 横 で 長 さが 微 妙 に 違 うもの
もあります。
右 のような 画 面 を 作 って、 実 際 のサイ
ズを 計 測 してみましょう。

画 面 サイズ 計 測 例
フォームエディタ 上 で 10 cm のものが・・・
Samsung Galaxy SC-01C: ほぼ 10cm で 表 示 された。
( 正 確 )
Samsung Galaxy Tab 7.7 (SC-01E): 8.1cmで 表 示 され
た。
Nexus 7: 横 は9.1cm、 縦 は9.4cm で 表 示 された
参 考 : なぜ、このような 結 果 になるのですか
‣ Magicは、Android OS のAPIを 通 して、 画 面 の dpi (Dot per inch) を
取 得 して、それをもとにコントロールのサイズ 計 算 を 行 います。
‣ フォームエディタ 上 で10cmになるはずのものが、10cmで 表 示 され
ないのは、APIが 返 すdpi 値 と、 現 実 のdpi 値 とが 異 なっているため
です。

フォームサイズの 計 算
画 面 の 物 理 サイズ = フォームサイズ ✕ 縮 小 倍 率
なので、
フォームサイズ = 画 面 の 物 理 サイズ ÷ 縮 小 倍 率
となります
例 : Galaxy Tab 7.7 SC-01E の 場 合
画 面 の 物 理 サイズ (タイトル 部 分 を 除 く): 10.3 ✕ 15.5 cm
縮 小 倍 率 : 10cm のものが 8.1cm で 表 示 されたのだから、0.81
∴ フォームサイズは
横 (W): 10.3/0.81 = 12.7cm
縦 (H): 15.5/0.81 = 19.1 cm

フォームモデルを 登 録 しましょう
基 本 のフォームサイズが 決 まったら、モデルに 登 録 しておきま
しょう

基 本 フォームサイズを 決 めます
上 記 のような 計 測 を、 利 用 予 定 の 各 デバイスについて 行 います。
その 中 で、 小 さめのものを 基 準 にして、 基 本 フォームサイズを 決
定 しましょう。
画 面 の 大 きさが 大 きく 異 なるフォームモデルを、2~3 種 類 ほど
登 録 しておくのがよいでしょう。
大 → タブレット 向 け
小 → スマホ 向 け
中 → ( 必 要 に 応 じ) 小 型 タブレット

コントロールのサイズ
コントロールについても、Studio のフォームエディタ 上 の 表 示 と、
Android デバイス 上 での 実 際 の 見 え 方 は 異 なります。
エディットコントロール
プッシュボタン
コンボボックス
チェックボックス
一 般 に、Windows RIAと 比 べ、
余 白 や 境 界 線 が 大 きいので、そのままだと 文 字 が 潰 れます。
サイズを 大 きめに 作 成 してください。
機 種 により 見 え 方 が 異 なるので、 実 機 で 確 認 しましょう。

Galaxy SC-01C Nexus 7

文 字 の 大 きさを 確 認 しましょう
フォームが 決 まったら、 次 に、 標 準 文
字 サイズを 決 めましょう。
同 じ9ptのフォントでも、 実 際 に 表 示 さ
れる 大 きさが 異 なることが 多 いようで
す。
文 字 が 大 きすぎると、 表 示 できる 内 容
が 少 なくなります。 小 さすぎると 読 み
にくくなります。
ボタンが 小 さすぎると、 指 で 押 すのに
苦 労 します。
これも、 実 機 で 使 用 感 を 確 認 しておき
ましょう。

エディットコントロールでのデータ 入 力
Android 上 でエディットコントロールにデータを 入 力 するには、 一
般 的 にはソフトキーボードを 使 います。
ソフトキーボード 操 作 については、すでに「ソフトキーボードでの
制 約 は」 以 下 で 説 明 しました。
それ 以 外 に 次 のような 点 に 留 意 してください。
マスク 文 字 の 扱 い: 入 力 完 了 後 に 適 用 されます。
IME 制 御 (「 漢 字 入 力 」 特 性 ): ソフトキーボードの 種 類 の 自
動 設 定 として 実 装 されています。
日 付 ・ 時 刻 型 : DateTime Picker が 使 えます。
ソフトキーボードを 表 示 させないようにするには

マスク 文 字 の 扱 い
入 力 中 は、マスク 文 字
が 適 用 されません。
エディットコントロール
から 抜 けた 時 点 で 適
用 されます。
初 期 状 態 : マ
スク 文 字 が 表
示 されている
入 力 中 : マス
ク 文 字 は 表 示
されない。
参 考 : ソフトキーボードの
入 力 予 測 機 能 を 活 用 する
ための 仕 様 です。
入 力 終 了 後 (フォーカ
ス 移 動 ): 入 力 データ
にマスク 文 字 が 適 用
されて 表 示 される。

IME 制 御
Android RIAでのIME 制 御 機 能 は、ソフトキーボードの 種 類 の
指 定 、という 形 で 実 現 されています。

IME 制 御 : 文 字 型 およびUNICODE 型 の 場 合
標 準 : かな 漢 字 入 力 あり。 入 力
予 測 あり。
半 角 英 数 : かな 漢 字 機 能 なし。
入 力 予 測 なし。
「 漢 字 入 力 」 特 性 では、8 ( 半 角 英 数 )
のみ 有 効 。
K 書 式 では、K0 および K8 (いずれも、
半 角 英 数 )のみ 有 効 。
注 意 : ソフトキーボードの 機
能 に 依 存 します。

IME 制 御 : 数 値 型 の 場 合
数 値 : 数 字 キーパッドが 表 示 されます。
かな 漢 字 機 能 、 入 力 予 測 はありません。

日 付 ・ 時 刻 型 : DateTimePickerが 使 えます
日 付 型 、あるいは 時 刻 型 のエディット 項
目 にカーソルが 移 動 すると、
DateTimePicker が 表 示 され、 値 を 設
定 することができます。
( 注 意 ) 時 刻 型 でDateTimePickerを 使
うと、 秒 単 位 の 指 定 ができません。 秒 は
00 になります。
TimePicker
DatePicker

DateTimePickerが 出 ないようにするには・・・
DateTimePicker を 表 示 させないで、
ソフトキーボードで 入 力 できるように
したい 場 合 には、エディットコント
ロールの「 追 加 情 報 」 特 性 に、
picker=0 と 指 定 します。
ソフトキーボード
が 表 示 される

ソフトキーボードを 表 示 させないようにしたい・・・
ソフトキーボードは、 画 面 の1/3 ~ 半 分 の 領 域 を 占 有 してし
まうので、 入 力 を 行 わない 項 目 では、ソフトキーボードを 表 示 さ
せないようにしたい、と 思 うことがあります。
ソフトキーボードは、 入 力 ( 修 正 )ができないところでは 表 示 され
ないので、Magicプログラム 側 で、 修 正 できないように 設 定 して
やります。
タスクを 照 会 モードとする → 全 てのエディットコントロールで、
ソフトキーボードが 出 ないようになります。
エディットコントロールの「 修 正 許 可 」 を No にします。

Windows システム 色 の 効 果
※ Windowsシステム 色 が 指 定 されると、Androidのネイティブの 表 示
方 法 で 表 示 されます。
フォーム: 背 景 が 黒 になります

エディット:
大 きめの 枠 が 表 示 されま
す
コンボボックス:
下 矢 印 が 表 示 されます

フォントを 変 えたいときには・・・
Android に 標 準 で 備 わっているフォントの 数 は 限 られていま
す。
sans-serif → 飾 りが 無 い (ゴシック 似 )
serif → 飾 りがある ( 明 朝 似 )
monospace → 文 字 幅 が 一 定
これらの 名 前 のフォントはStudioのフォントテーブルでは 設 定
できないので、フォント 定 義 ファイルにテキストエディッタで 直
接 修 正 します。

Android フォント 設 定 例
・・・
iOS Zapfino,Zapfino,9,128,0
iOS,Helvetica,9,128,0
メイリオ,メイリオ,9,128,0
Android Sans,sans-serif,14,128,0
Android Serif,serif,14,128,0
Android Sans Mono,monospace,14,128,0
Android Bold Serif,serif,14,128,0,Bold

Androidフォント 表 示 結 果

フォーム 「 追 加 情 報 」
フォームの「 追 加 情 報 」 欄 にフラグを 指 定 して、 以 下 のようなことが
できます。
orientation: 縦 長 、または 横 長 に 強 制 的 に 設 定 する。
popup: ポップアップフォームにする。
VerticalScroll, HorizontalScroll: スクロールの 方 法 を 指 定 。

フォーム 「 追 加 情 報 」 1 Orientation
方 向 の 固 定 をしたい 場 合 には・・・
orientation=Portrait ( 横 長 に 固 定 )
orientation=Landscape ( 縦 長 に 固 定 )

フォーム 追 加 情 報 2 Popup
ポップアップフォーム
popup=Y
→ ポップアップウィンドウになります。

フォームのスクロールの 基 本
フォームが 画 面 サイズより 大 きい 場 合 、スワイプ 動 作 でスクロー
ルできますか
→ フォーム 全 体 がスクロールします。( 縦 方 向 、 横 方 向 ともに 可
能 )
スクロール

テーブルがある 場 合 のスクロール
ただし、テーブルがある 場 合 には
レコードがスクロールします ( 縦 方 向 )
横 方 向 、フォーム 全 体 はスクロールしません。
‣ ※ iOS の 場 合 には、テーブル 内 のレコードのスクロール、
フォーム 全 体 のスクロール 両 方 が 可 能 でしたが、Android の
場 合 にはどちらか 一 方 だけが 可 能 です。(これはAndroidの 制
限 事 項 です)
‣ この 動 作 は、テーブルの 他 に、ブラウザ、サブフォームがある
場 合 にも 適 用 されます。

テーブルがある 場 合 のスクロール
レコードのスクロールは
できる。
フォーム 全 体 のスク
ロールはできない。
( 縦 、 横 とも)

テーブルがある 場 合 のスクロール
ということは・・・
画 面 外 、 右 下 にあるボタンは、 表 示 できません。
右 側 にはみ 出 したカラムは 表 示 できません。
これが 画 面 範 囲 と
すると・・・
はみ 出 た 部 分 は 表
示 できません

スクロール 関 係 の「 追 加 情 報 」 特 性
デフォルトの 動 作 を 変 えたい 場 合 には・・・
スクロールの 動 作 を 指 定 するため、フォームの「 追 加 情 報 」 特 性
に、 以 下 を 指 定 します。
ScrollVertical=Y/N ( 縦 方 向 のスクロール 指 定 )
ScrollHorizontal=Y/N ( 横 方 向 のスクロール 指 定 )
ScrollVertical= Y N
フォーム 全 体 スクロールする スクロールしない
テーブル 内 レコード スクロールしない
スクロールする
ScrollHorizontal= Y N
フォーム 全 体 スクロールする スクロールしない
テーブル 内 レコード スクロールしない
スクロールしない

テーブルのある 場 合 のスクロール( 続 )
縦 方 向 にはレコードのスクロールをして、 横 方 向 にはフォーム 全 体 の
スクロールをする ( 右 側 にはみ 出 したカラムも 表 示 させたい)、という
動 作 を 可 能 にするには、
ScrollVertical=N,ScrollHorizontal=Y
と 設 定 しておく。
※ モデルに 登 録 しておく
と 便 利

サブフォーム 内 のスクロール
サブフォームの 中 の 子 タスクのスクロールについては、
デフォルトの 動 作 として、フォーム 全 体 がスクロールされます。
→ サブフォーム 中 のテーブルのレコードはスクロールしません。
テーブルレコードをスクロールさせるには、
VerticalScroll=N をサブフォームの「 追 加 情 報 」に 指 定 しま
す。
※ ブラウザコントロールの 場 合 も 同 様 です。

パフォーマンスに 関 する 考 慮 事 項
Mobile デバイスは、CPUのパワーや、ソフトウェアの 実 装 方 法
の 違 いにより、Windows PCよりかなり 遅 いです。
∴ Magic のMobile RIAも 遅 いです。
ということは、 画 面 設 計 、ロジックに 考 慮 が 必 要 になります。
実 験 : 精 密 な 測 定 ではないが、 傾 向 を 見 てみましょう。
ブロックWhileでループ
コントロール 数 の 影 響

ブロック While ループ
純 粋 なMagicクライアントモジュールの 処 理 速 度 比 較 として、ブロッ
ク While コマンドで、10,000 回 のループを 回 すプログラムを 実 行 し、
時 間 を 計 測 してみます。
Windows RIA: 0.47 秒
(Core2 Quad Q6600 @2.4GHz → 4 年 前 のCPU)
Android RIA: 29.7 秒
(Galaxy Tab 7.7、APQ8060 1.5GHz(Dual Core) → 最 新 の
CPU)
※ その 差 60 倍 以 上 !
※ クアッドコアのCPUだと、 何 割 か 早 くなるが、 劇 的 な 改 善 は 期 待 でき
ない。

コントロール 数 の 多 寡 による 違 い
次 に、 画 面 上 のコントロール 数
が 多 くなると、 処 理 速 度 がどう 変
わるかを 見 てみましょう。
APGでテーブル 形 式 表 示 プログ
ラムを 作 成 します。
タスク 起 動 から、 全 データが 表
示 されるまでの 時 間 を 計 測 しま
す。
表 示 するカラムを 追 加 ・ 削 除 して、
表 示 する 全 コントロール 数 を 変
えて、 測 定 ・ 比 較 します。

計 測 結 果
Windows RIA: 1 秒 以 内 に 表 示 されます。
Android RIA:
7カラム×25 行 (175コントロール) → 5.3 秒
22カラム×25 行 (550コントロール) → 16 秒
コントロール 数 が 増 えると、 非 常 に 遅 くなります。
( 画 面 上 に 表 示 されているか 否 か、「 可 視 」 特 性 の 設 定 に 関 わり
ません)
スクロールも 同 様 に 遅 くなります。
例 : 22×25のテーブルなどでは、ほとんど 動 かないと 言 ってい
いほどの 遅 さになります。

パフォーマンスの 考 慮 (まとめ)
Mobile デバイスは、Windows PCに 比 べて、 文 字 通 り 桁 違 いに
非 力 です。(iOS デバイスでも、 同 様 のレベルです)
Windows RIAと 同 じ 感 覚 で 多 くのコントロールを 配 置 して 画 面
設 計 していると、 非 常 に 遅 くなる 可 能 性 があります。
画 面 に 配 置 するコントロール 数 は 極 力 減 らすようにしてください。
ロジックも 簡 単 化 してください。
チャンクサイズは、 処 理 レコード 数 に 影 響 するので、 大 きすぎる
とやはり 遅 くなります。 必 要 最 小 限 にしてください。
参 考 : サーバ 側 ロジック (バッチタスクなど)は、
サーバ 上 で 実 行 されるものなので、Mobile RIAでも
Windows RIAでも 処 理 時 間 は 同 じです。

付 録

Android RIAで 使 えるコントロールは
Android RIAでは、 以 下 のコントロールが 利 用 できます。
ラベル
エディット
ボタン
グループ
ライン
イメージ
ブラウザ
チェックボックス
コンボボックス
テーブル
カラム
サブフォーム
注 意 : これ 以 外 のコントロールは、
Studio のフォームエディッタで 配 置 して
も、 実 行 時 に 無 視 されます。

メインプログラムのウィンドウ 表 示
Hello Magic 実 行 前 に、プロジェクトの 変 更 を 行 い、メインプログ
ラム → タスク 特 性 → インターフェース タブ → ウィンドウ 表 示
に No を 設 定 しました。
これはなぜ 必 要 だったのでしょうか

この 設 定 をしておかないと・・・
「ウィンドウ 表 示 」 特 性 を 設 定 しない (Yesのまま) で、「デバッグ
→ プロジェクトの 実 行 (J)」で 待 機 状 態 にすると、ランタイムの 画
面 が 表 示 されます。
この 状 態 で、Android RIA を 起 動 すると、エラー -138 が 出 ます。
エラーコード -138 の 意 味 は、「オンラインのMDIが 開 いている
場 合 、リッチクライアントのリクエストは 処 理 できません」です。
※ Mgerror.log にも 記 録 されます。

対 応 方 法 は
待 機 状 態 で、オンライン
の MDI 画 面 を 開 かない
ようにしておく 必 要 があり
ます。
この 画 面 が 出 な
いようにする 必
要 がある。

対 応 方 法 1: バックグラウンドで 起 動
動 作 環 境 の「 実 行 モード」を「B=
バックグラウンド」にセットして
Studio を 起 動 すると、オンライン
のMDI 画 面 が 表 示 されないので、
エラーが 出 なくなります。
RIAサーバで 実 際 に 運 用 する 場 合
には、この 設 定 で 実 行 します。
Studioでこの 設 定 を 使 っていると、
オンラインのプログラムが 実 行 で
きません。
例 : データリポジトリからAPGで 表
示 、プログラムリポジトリからF7で
オンラインプログラムの 実 行 など
ができない。
→ 開 発 時 にはちょっと 不 便 な 設 定
かも。

対 応 方 法 2: ウィンドウ 表 示 をNoに
別 の 対 応 方 法 としては、メインプログラムの「ウィンドウ 表 示 」を
No にしておけば、オンラインのMDI 画 面 が 表 示 されなくなりま
す。
メインプログラムの 画 面 が 出 なくなるだけで、テーブルリポジトリ
からのAPGとか、プログラムリポジトリから F7 でのオンライン
実 行 などは、できます。
Studio で 開 発 時 には、こうしておくのが 便 利 でしょう。
参 考 : より 細 かな 制 御 をしたい 場 合
には、RunMode() 関 数 を 使 って、
「ウィンドウ 表 示 」を 式 で 設 定 するこ
とも 考 えられます。

.apk ファイルをIISでダウンロード 可 能 にするには
.apk ファイルをWebサーバの 仮 想 ディレクトリ 上 に 置 いて、
Android のWebブラウザからダウンロードしようとすると、エ
ラーが 出 ます。
ダウンロード 可 能 にするには、IISでMIME 設 定 が 必 要 です。

MyApp.apk をIIS
のルートディレ
クトリに 置 く。
Androidからダ
ウンロードしよう
とするとエラー
になる。
参 考 : IISのバー
ジョンにより、エ
ラーメッセージ
が 違 うことがあ
ります。

IIS のMIME 設 定
エラーを 回 避 するには、 以 下 のように、IISでMIME 設 定 を 行 う 必 要
があります。
拡 張 子 : .apk
MIMEの 種 類 : application/vnd.android.package-archive

IISサービスマネージャ
Default Web Site
→ MIMEの 種 類
追 加
拡 張 子 とMIMEの 種
類 を 設 定 。

このようになれば、ダウンロードできるようにな
ります。