iPadのホーム画面に大きなショートカットアイコンを追加する
Scriptableウィジェットを使い、iPadのホーム画面に大きなカスタム画像を置き、タップでiOSショートカットを実行する手順です。
概要
- このガイドでは、iPadのホーム画面に大きな画像を置き、タップするとiOSのショートカットを実行する方法を説明します。
- 目的は、ショートカットアプリの標準アイコンではなく、大きくタップできるアイコンを追加することです。
- 無料のScriptableアプリと、短いJavaScriptのウィジェットスクリプトを使います。
- 対象は、すでにショートカットを使っていて、ホーム画面の起動用アイコンを大きくしたいiPadユーザーです。
事前準備
Scriptableをインストールする
- iPadでApp Storeを開きます。
- Scriptableを検索し、Scriptableをインストールします。
ScriptableはiPad上でJavaScriptを実行し、ホーム画面のウィジェットを描画します。
ショートカットを作成または選択する
- ショートカットアプリを開きます。
- 新しいショートカットを作成するか、既存のショートカットの正式名称を控えます。
- この手順では
Example Shortcutと名前を付けるか、今の名前のままにして、あとでスクリプトを更新します。
ウィジェットは名前でショートカットを開きます。スクリプト内の文字列は、ショートカットアプリの名称と完全に一致させてください。
ウィジェット用の画像を用意する
ウィジェットのサイズでも内容が読み取れる、正方形かそれに近い画像を選びます。iPadで大きなアイコンのように見せるには、中サイズまたは大サイズのホーム画面ウィジェットが向いています。
大きなショートカットアイコンを追加する手順
Step 1:Scriptableのスクリプトを追加する
- Scriptableを開きます。
- +をタップして、新しいスクリプトを作成します。
- 下のウィジェットスクリプトをエディタに貼り付けます。
- ショートカット名が
Example Shortcutでない場合は、スクリプト上部のSHORTCUT_NAMEを変更し、ショートカットアプリの名称と完全に一致させます。 - Doneまたは閉じるボタンをタップして、スクリプトを保存します。
- Scriptable上のスクリプト名を、
Example Shortcut iconのように、あとから見分けられる名前に変更します。
注意:画像を選んだあとにスクリプト名を変えない
保存される画像はスクリプト名で保存されます。名前を変えると画像を見つけられなくなり、ウィジェットに「Open Scriptable and run this script once.」が再び表示されます。名前を変えた場合は、スクリプトを再実行して画像を選び直してください。
Step 2:ウィジェットの画像を選ぶ
- Scriptableでスクリプトを開きます。
- Playボタンをタップして、アプリ内で実行します。
- 写真の選択画面が表示されたら、用意した画像を選びます。
- Scriptableがプレビューサイズを尋ねたら、MediumまたはLargeなど、追加するウィジェットのサイズを選びます。
- Scriptableが表示するプレビューを確認します。
Scriptable内でスクリプトを1回実行すると、画像がウィジェット向けのサイズに縮小され、Scriptableのローカルファイルに保存されます。ホーム画面のウィジェットには、この保存ファイルが必要です。
Step 3:ホーム画面にScriptableウィジェットを追加する
- iPadのホーム画面で、何もない場所を長押しし、アプリが揺れるまで待ちます。
- 左上の編集をタップし、ウィジェットを追加をタップします。
- Scriptableを検索し、中または大のウィジェットサイズを選びます。
- ウィジェットを追加をタップし、完了をタップします。
- 新しいウィジェットを長押しし、ウィジェットを編集をタップします。
- Scriptを、作成したスクリプトに設定します。
- Scriptableのパラメータをすでに使っている場合を除き、他のオプションは初期設定のままにします。
- 設定画面の外側をタップします。ホーム画面がまだ編集モードなら、完了をタップします。
ウィジェットに選んだ画像が表示されます。タップすると、SHORTCUT_NAMEに書いた名前のショートカットが実行されます。
ウィジェットスクリプト
// CHANGE THIS to the exact name of your Apple Shortcut.
const SHORTCUT_NAME = 'Example Shortcut';
// Longest side, in pixels, of the saved image.
// Widgets have little memory, so full-size photos can render blank.
const MAX_IMAGE_SIZE = 1000;
const fm = FileManager.local();
// Each script saves its own image, named after the script.
const imagePath = fm.joinPath(fm.documentsDirectory(), Script.name() + '.png');
// Build the widget, or a reminder to pick an image if none is saved yet.
function createWidget(image) {
const widget = new ListWidget();
if (!image) {
widget.addText('Open Scriptable and run this script once.');
return widget;
}
// Use the selected picture as the entire widget background.
widget.backgroundImage = image;
// Remove unnecessary internal spacing.
widget.setPadding(0, 0, 0, 0);
// Tapping anywhere on the widget runs the Apple Shortcut.
widget.url =
'shortcuts://run-shortcut?name=' + encodeURIComponent(SHORTCUT_NAME);
return widget;
}
// Shrink the image so its longest side is at most MAX_IMAGE_SIZE.
function resizeImage(image) {
const { width, height } = image.size;
const scale = MAX_IMAGE_SIZE / Math.max(width, height);
if (scale >= 1) {
return image;
}
const size = new Size(Math.round(width * scale), Math.round(height * scale));
const context = new DrawContext();
context.size = size;
context.opaque = false;
context.respectScreenScale = false;
context.drawImageInRect(image, new Rect(0, 0, size.width, size.height));
return context.getImage();
}
// Let you choose a new image. Returns null if you cancel the picker.
async function pickImage() {
try {
return resizeImage(await Photos.fromLibrary());
} catch {
return null;
}
}
function loadSavedImage() {
return fm.fileExists(imagePath) ? fm.readImage(imagePath) : null;
}
// Preview the widget at the size you use on the Home Screen.
async function previewWidget(widget) {
const alert = new Alert();
alert.title = 'Preview';
alert.message = 'Choose the widget size you use on the Home Screen.';
alert.addAction('Small');
alert.addAction('Medium');
alert.addAction('Large');
alert.addCancelAction('Skip');
const choice = await alert.presentAlert();
if (choice === 0) {
await widget.presentSmall();
} else if (choice === 1) {
await widget.presentMedium();
} else if (choice === 2) {
await widget.presentLarge();
}
}
if (config.runsInApp) {
// When you manually run this script inside Scriptable,
// let you choose or replace the widget image.
// Cancel the picker to preview the saved image again.
const pickedImage = await pickImage();
if (pickedImage) {
fm.writeImage(imagePath, pickedImage);
}
const image = pickedImage ?? loadSavedImage();
if (image) {
await previewWidget(createWidget(image));
}
} else {
// When iOS runs this as a Home Screen widget:
Script.setWidget(createWidget(loadSavedImage()));
}
Script.complete();補足情報
- アイコンを増やすには、ショートカットごとにScriptableでスクリプトを複製します。複製ごとに固有の名前と
SHORTCUT_NAMEを付け、それぞれ1回実行して画像を選びます。画像はスクリプト名ごとに保存されるため、ウィジェット同士で上書きしません。 - 画像をあとから変えるには、Scriptableでスクリプトを開き、再実行します。写真の選択画面で保存済みの画像が置き換わり、次の更新でウィジェットに反映されます。今の画像を置き換えずにプレビューするには、写真の選択をキャンセルします。
- 同じスクリプトを、小、中、大のScriptableウィジェットで使えます。中と大は、iPadの大きなアプリアイコンに最も近く見えます。
トラブルシューティング
ウィジェットに「Open Scriptable and run this script once.」と表示される
保存された画像がまだないか、画像を保存したあとにスクリプト名を変更しています。Scriptableでスクリプトを開き、Playで実行して、画像を選びます。
ウィジェットをタップしても何も起きない、または別のショートカットが実行される
SHORTCUT_NAMEがショートカットアプリの名称と、大文字と小文字、および空白も含めて一致しているか確認します。ショートカット側か定数側の名前を揃え、スクリプトを保存してから、ウィジェットを編集してスクリプトを選び直します。
ウィジェットが空白になる、または古い画像が表示される
- Scriptable内でスクリプトを1回実行し、保存画像を書き直します。
- ウィジェットを長押ししてウィジェットを編集をタップし、正しいスクリプトが選ばれているか確認します。
- それでも更新されない場合は、iPadを再起動します。
Scriptableが写真へのアクセスを求める
表示されたら、写真へのアクセスを許可します。アプリ内の実行はPhotos.fromLibrary()でウィジェット画像を選びます。