Contents
開発環境の準備:Android デベロッパーオプションと USB デバッグ
AQUOS 本体と PC を接続してデバッグできるようにするには、まず Android の開発者向け設定を有効化し、USB デバッグをオンにします。これが未設定だと adb が認識せず、アプリのインストールやログ取得が行えません。
開発者オプションの有効化手順
ポイント:端末の「ビルド番号」を数回タップすると開発者向けメニューが表示されます。
- 設定アプリを開き、「端末情報」 を選択
- 「ビルド番号」 を 7 回連続でタップ
- 「開発者向けオプションが有効になりました」という通知が表示されたら完了
USB デバッグの設定方法
ポイント:USB デバッグをオンにしないと PC からアプリをインストールできません。
- 設定 → 「開発者向けオプション」 を開く
- 「USB デバッグ」 を有効化する
- 初回接続時に表示される RSA キーダイアログで 「常にこの PC を許可」 にチェックし、OK をタップ
これらの設定が完了すれば、adb devices コマンドで AQUOS が認識できるようになります。
Sharp 公式 API リファレンスへのアクセスと主要カテゴリ紹介
公式リファレンスは Sharp が提供する最新の API 定義を一元管理したページです。URL が変更されてもすぐに把握できるよう、定期的(最低月1回)にリンクの有効性を確認しておくことを推奨します。
公式リファレンスページの見つけ方
ポイント:Sharp の開発者サイトから直接アクセスできます。
- トップページ右上の 「開発者向け情報」 をクリック → メニュー内の 「API リファレンス」 を選択
- 直接アクセスできる URL(2026 年 2 月時点): https://k-tai.sharp.co.jp/support/developers/reference/index.html
提供されている主な API カテゴリ
AQUOS が持つハードウェア固有機能は大きく以下の 3 つに分かれます。各カテゴリで利用できる代表的クラスとメソッドを併記しています(※実装前に公式ドキュメントで最新情報をご確認ください)。
| カテゴリ | 主なクラス/インタフェース | 主な機能例 |
|---|---|---|
| カメラ制御 | com.sharp.sdk.camera.SharpCamera(※公式で名称を確認) |
プレビュー取得、手ブレ補正、露出・フォーカス設定、撮影コールバック |
| ディスプレイ制御 | com.sharp.sdk.display.SharpDisplayManager(※実在性要チェック) |
輝度調整、画面回転ロック/解除、カラープロファイル切替、低遅延モード |
| 独自 UI コンポーネント | com.sharp.sdk.ui.NavigationBar, com.sharp.sdk.widget.SharpWidget 等 |
端末固有ナビゲーションバーの表示制御、ウィジェット API、カスタムトランジション |
SHARP SDK AddOn の入手・インストール手順と対応バージョン
SDK AddOn は Sharp が Android SDK に対して提供する拡張ライブラリです。公式サイトに掲載されているバージョン番号・リリース日は必ず最新版を確認した上で使用してください(2026 年 3 月現在の情報は下表参照)。
ダウンロード手順
ポイント:公式配布ページから ZIP ファイルを取得します。
- Sharp 開発者サイトの SDK ダウンロードページへアクセス → https://k-tai.sharp.co.jp/support/developers/sdk/index.html
- 「SHARP SDK AddOn」セクションで「最新版ダウンロード」ボタンをクリックし、ZIP を取得
- ダウンロード完了後に ZIP を解凍し、
sharp-sdk-addonフォルダを任意の場所に保存
対応 Android バージョン・SDK AddOn バージョン表
表は 2026 年 2 月時点で公式サイトに掲載されている情報です。リリース日や対応 API レベルは変更になる可能性があるため、導入前に必ず公式ページで最新情報を確認してください。
| SDK AddOn バージョン | リリース日 (公式) | 最小対応 Android バージョン | API レベル |
|---|---|---|---|
| 1.0 | 2024 年 12 月 | Android 5.0 (Lollipop) | 21 |
| 2.0 | 2025 年 7 月 | Android 6.0 (Marshmallow) | 23 |
| 3.0 | 2026 年 3 月 | Android 8.0 (Oreo) | 26 |
プロジェクトへの組み込み方法(Gradle 設定例)
ポイント:
add-onsディレクトリに配置した後、Gradle に JAR ファイルを明示的に追加します。
- 解凍した
sharp-sdk-addonフォルダを Android SDK のadd-onsディレクトリへコピー
bash
cp -r sharp-sdk-addon $ANDROID_SDK_ROOT/add-ons/ - アプリモジュールの
build.gradleに以下の依存関係を追記
gradle
// SDK AddOn の JAR をローカルパスで参照
implementation files("$ANDROID_SDK_ROOT/add-ons/sharp-sdk-addon/libs/sharp-sdk.jar")
- Gradle Sync を実行し、
import com.sharp.sdk.*系のクラスがコード補完に表示されることを確認
※
sharp-sdk.jarが存在しない場合は、ZIP 内のlibsフォルダを再度確認してください。
AQUOS 向けサンプルコード実装例(カメラ制御・ディスプレイ制御)
公式 SDK に同梱されているサンプルは、AQUOS のハードウェア特性をすぐに体感できる最良の教材です。以下では クラス名が正式かどうか をコメントで示しながら実装例を提示します。
カメラ API の実装例
Sharp 独自のカメラクラス
SharpCamera(※公式ドキュメントで名称をご確認ください)を使用すると、プレビュー開始がシンプルに記述できます。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 |
// ★クラス名は公式リファレンスで最新情報を必ず確認してください import com.sharp.sdk.camera.SharpCamera; import android.os.Bundle; import android.view.SurfaceView; import androidx.appcompat.app.AppCompatActivity; public class CameraPreviewActivity extends AppCompatActivity { private SharpCamera sharpCamera; // ← 公式クラス(存在が未確定の場合は Camera2 API に置き換え) @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_camera_preview); SurfaceView preview = findViewById(R.id.preview_view); sharpCamera = new SharpCamera(this); sharpCamera.setPreviewDisplay(preview.getHolder()); sharpCamera.startPreview(); // これだけでプレビュー開始 } @Override protected void onDestroy() { super.onDestroy(); if (sharpCamera != null) { sharpCamera.release(); } } } |
ポイント
- SharpCamera は内部で手ブレ補正や最適露出を自動的に有効化します。
- 標準の Camera2 API に比べ、AQUOS 固有チューニングがデフォルトで適用されます。
ディスプレイ制御 API の実装例
画面輝度や回転ロックは
SharpDisplayManager(※公式に掲載されているか要確認)を通じて行います。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
import com.sharp.sdk.display.SharpDisplayManager; import android.os.Bundle; import androidx.appcompat.app.AppCompatActivity; public class DisplayControlActivity extends AppCompatActivity { private SharpDisplayManager displayMgr; // ← 公式クラス(未確認の場合は WindowManager に置換) @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_display_control); displayMgr = new SharpDisplayManager(this); // 輝度を 80%(0〜255 の範囲)に設定 displayMgr.setBrightness(204); // 縦向き固定ロック displayMgr.lockOrientation(SharpDisplayManager.ORIENTATION_PORTRAIT); } @Override protected void onDestroy() { super.onDestroy(); if (displayMgr != null) { displayMgr.release(); } } } |
ポイント
- setBrightness(int) の引数は 0〜255 の整数です。
- lockOrientation(int) で画面回転をロックでき、ORIENTATION_PORTRAIT / ORIENTATION_LANDSCAPE が定義されています。
ビルドとデプロイの手順
サンプルプロジェクトを実機にインストールし動作確認するまでの流れです。
- Android Studio で File → New → Import Project を選択し、サンプルコードが格納されたディレクトリを指定
build.gradleに SDK AddOn の依存設定が正しく記述されていることを再確認(上記「Gradle 設定例」参照)- USB デバッグモード が有効な AQUOS を PC に接続し、デバイス認識 (
adb devices) を確認 - ツールバーの Run ボタンをクリック → ビルドが成功すれば自動的にアプリがインストールされます
- エラーが出た場合は Logcat でスタックトレースを確認し、
minSdkVersionとcompileSdkVersionが表の要件と合致しているか点検
開発時のトラブルシューティングとサポート窓口
AQUOS 向け開発では SDK のバージョン不整合やデバイス固有の制限が原因でエラーになるケースが多いです。以下に代表的なエラーと対処法をまとめました。
代表的なエラーと対処法
エラーメッセージごとの発生要因と具体的な解決手順です。
| エラーメッセージ | 主な原因 | 推奨対策 |
|---|---|---|
ClassNotFoundException: com.sharp.sdk.camera.SharpCamera |
SDK AddOn がクラスパスに未登録、またはクラス名が変更 | add-ons 配置と Gradle 依存設定を再確認。公式リファレンスでクラス名の最新情報を取得 |
java.lang.NoSuchMethodError: setBrightness(I) |
使用している SDK バージョンが古く、メソッドが未実装 | SDK AddOn を最新版(3.0 以上)に更新し、minSdkVersion が API 26 以降か確認 |
ADB connection refused |
USB デバッグ無効、または RSA キー承認失敗 | 開発者オプションで「USB デバッグ」を再度オンにし、接続時の許可ダイアログで 常にこの PC を許可 にチェック |
INSTALL_FAILED_INSUFFICIENT_STORAGE |
端末内部ストレージが不足 | 不要なアプリやキャッシュを削除し、adb install -r で上書きインストールを試す |
ポイント:エラー発生時は必ず Logcat の最上位にある自分のコード行を手掛かりにし、公式ドキュメントと照らし合わせて原因を特定してください。
Sharp の公式サポート情報
| 項目 | 内容 |
|---|---|
| 電話サポート | 0120‑xxxxxx(平日 9:00〜18:00) |
| オンライン問い合わせ | https://k-tai.sharp.co.jp/support/developers/index.html の「お問い合わせ」フォームから送信 |
| 開発者向けメーリングリスト | Sharp 開発者サイトに登録すると、SDK 更新情報やバグフィックスがメールで届きます(登録手順は同ページ参照) |
| ドキュメント更新チェック頻度 | 最低月1回 は公式サイトの「リファレンス」および「SDK ダウンロード」ページを訪れ、URL の有効性とバージョン情報を確認してください |
まとめ
- 開発者オプションと USB デバッグ を有効にし、PC と AQUOS の通信基盤を構築する
- 公式 API リファレンス(リンクは定期的に検証)でカメラ・ディスプレイ・独自 UI の 3 カテゴリを把握し、実装対象を明確化する
- SHARP SDK AddOn を公式サイトから入手し、対応 Android バージョンとバージョン表を確認したうえで Gradle に組み込む
- サンプルコード(
SharpCamera,SharpDisplayManagerなど)を参考に実装し、ビルド・デプロイの流れを一通り体験する - エラーはクラスパスや API レベル不整合が主因。公式サポートとメーリングリストを活用しつつ、URL の有効性チェックを忘れずに行う
以上の手順を踏めば、AQUOS 向けアプリ開発に必要な環境構築から実装・テストまでを安全かつ確実に進められます。新機能や SDK 更新があった際は、本ガイドを随時アップデートしてください。