StarXpand SDK for iOS / Android 開発者向けマニュアル Ver. 1.8.0

最終更新日: 2024年 11月 1日

FAQ

このページを見ても問題が解決しない場合は、GithubのIssues (iOS)Issues (Android)もご確認ください。

Q : どのOSや開発言語がサポートされていますか

A : iOS、Androidで動作するネイティブアプリをサポートしています。
iOSの開発言語はSwiftをサポートしております。 iOSのOSサポートバージョンはこちらのページを参照してください。
Androidの開発言語はKotlinをサポートしております。 AndroidのOSサポートバージョンはこちらのページを参照してください。

Q : このSDKを自分のアプリで利用するにはどうすればよいですか

A : 下記のページの手順に従い、StarIO10ライブラリをアプリに組み込んでください。
iOS: https://github.com/star-micronics/StarXpand-SDK-iOS/blob/main/docs/README_JP.md#導入
Android: https://github.com/star-micronics/StarXpand-SDK-Android/blob/main/docs/README_JP.md#導入

Q : タブレットやPCとプリンターを接続するためには何を行う必要がありますか

A : 初期設定を行います。使用するOS、インターフェイスによって初期設定方法が異なります。こちらのページで利用環境を選択し、手順に沿って設定してください。

Q : バーコードリーダーは利用できますか

A : 利用できます。プリンターに USB 接続したバーコードリーダーで読み取ったバーコードを、プリンター経由で取得することができます。具体的な実装方法はこちらのページを参照してください。

Q : ログは取得できますか

A : 取得できます。ログ機能の利用方法はこちらのページにある項目『ログを取得する』を参照してください。
ログ機能はテスト運用時やトラブル発生時の解析に利用することを想定しており、アプリケーションのパフォーマンスに影響を与える可能性があります。

Q : iOS版のV1.0.0からV2.0.0以降に移行するためには何をすればよいですか

A : StarXpand SDK V2.0.0 より、StarPrinter クラスのメソッドの対応するOSバージョンが変更され、呼び出し側コードの変更が必要となりました。
具体的な変更内容はこちらのページを参照してください。

Q : アプリのArchiveに失敗します

A : アプリのArchive時に下記のエラーが発生した場合、StarIO10ライブラリのbitcode非対応化によるものです。本Answerの案内に従って対応してください。
..StarI010.framework/StarI010' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. ...

Xcode14よりbitcodeが非推奨となり、AppStoreでもbitcodeが使用されなくなりました。
この変更に従い、StarIO10ライブラリはStarXpand SDK iOS V2.3.0からbitcodeを含まなくなりました。
Xcode14リリースノート: https://developer.apple.com/documentation/xcode-release-notes/xcode-14-release-notes
アプリをbitcode有効に設定している場合、Build Settings > Enable BitcodeをYesからNoに変更してください。
Yesのままにした場合、アプリのArchiveがエラーで失敗します。

Q : 改訂履歴はどこで確認できますか

A : GitHubにて公開しております。以下のページを参照してください。
iOS: https://github.com/star-micronics/StarXpand-SDK-iOS/blob/main/docs/CHANGELOG_JP.md
Android: https://github.com/star-micronics/StarXpand-SDK-Android/blob/main/docs/CHANGELOG_JP.md

Q : SDK付属のサンプル印刷データが印刷されなかったり、レイアウトが崩れます

A : ご利用のモデルが対応している印刷データ生成APIを呼び出していることを確認してください。
・例1 - TSP100IIシリーズ、TSP100IIIシリーズは印刷データに文字列(actionPrintText(iOS)/actionPrintText(Android)メソッド参照)を指定することができません。 印字データは画像(actionPrintImage(iOS)/actionPrintImage(Android)メソッド参照)などで指定してください。
・例2 - TSP700IIシリーズはページモードAPIを使って印刷データを指定することはできません(addPageMode(iOS)/addPageMode(Android)メソッド参照)。

Q : ページモードを利用した印刷データのレイアウトが崩れます

A : PageModeAreaParameter(iOS)/PageModeAreaParameter(Android)を参照し、ページモードの印刷領域が正しく設定されていることを確認してください。ページモードの印刷領域が正しく設定されていないと、レイアウトが崩れたり、全く印字されない可能性があります。