本文へスキップ

iPadのホーム画面に大きなショートカットアイコンを追加する ​

Scriptableウィジェットを使い、iPadのホーム画面に大きなカスタム画像を置き、タップでiOSショートカットを実行する手順です。

概要 ​

  • このガイドでは、iPadのホーム画面に大きな画像を置き、タップするとiOSのショートカットを実行する方法を説明します。
  • 目的は、ショートカットアプリの標準アイコンではなく、大きくタップできるアイコンを追加することです。
  • 無料のScriptableアプリと、短いJavaScriptのウィジェットスクリプトを使います。
  • 対象は、すでにショートカットを使っていて、ホーム画面の起動用アイコンを大きくしたいiPadユーザーです。

事前準備 ​

Scriptableをインストールする ​

  1. iPadでApp Storeを開きます。
  2. Scriptableを検索し、Scriptableをインストールします。

ScriptableはiPad上でJavaScriptを実行し、ホーム画面のウィジェットを描画します。

ショートカットを作成または選択する ​

  1. ショートカットアプリを開きます。
  2. 新しいショートカットを作成するか、既存のショートカットの正式名称を控えます。
  3. この手順ではExample Shortcutと名前を付けるか、今の名前のままにして、あとでスクリプトを更新します。

ウィジェットは名前でショートカットを開きます。スクリプト内の文字列は、ショートカットアプリの名称と完全に一致させてください。

ウィジェット用の画像を用意する ​

ウィジェットのサイズでも内容が読み取れる、正方形かそれに近い画像を選びます。iPadで大きなアイコンのように見せるには、中サイズまたは大サイズのホーム画面ウィジェットが向いています。

大きなショートカットアイコンを追加する手順 ​

Step 1:Scriptableのスクリプトを追加する ​

  1. Scriptableを開きます。
  2. +をタップして、新しいスクリプトを作成します。
  3. 下のウィジェットスクリプトをエディタに貼り付けます。
  4. ショートカット名がExample Shortcutでない場合は、スクリプト上部のSHORTCUT_NAMEを変更し、ショートカットアプリの名称と完全に一致させます。
  5. Doneまたは閉じるボタンをタップして、スクリプトを保存します。
  6. Scriptable上のスクリプト名を、Example Shortcut iconのように、あとから見分けられる名前に変更します。

注意:画像を選んだあとにスクリプト名を変えない

保存される画像はスクリプト名で保存されます。名前を変えると画像を見つけられなくなり、ウィジェットに「Open Scriptable and run this script once.」が再び表示されます。名前を変えた場合は、スクリプトを再実行して画像を選び直してください。

Step 2:ウィジェットの画像を選ぶ ​

  1. Scriptableでスクリプトを開きます。
  2. Playボタンをタップして、アプリ内で実行します。
  3. 写真の選択画面が表示されたら、用意した画像を選びます。
  4. Scriptableがプレビューサイズを尋ねたら、MediumまたはLargeなど、追加するウィジェットのサイズを選びます。
  5. Scriptableが表示するプレビューを確認します。

Scriptable内でスクリプトを1回実行すると、画像がウィジェット向けのサイズに縮小され、Scriptableのローカルファイルに保存されます。ホーム画面のウィジェットには、この保存ファイルが必要です。

Step 3:ホーム画面にScriptableウィジェットを追加する ​

  1. iPadのホーム画面で、何もない場所を長押しし、アプリが揺れるまで待ちます。
  2. 左上の編集をタップし、ウィジェットを追加をタップします。
  3. Scriptableを検索し、中または大のウィジェットサイズを選びます。
  4. ウィジェットを追加をタップし、完了をタップします。
  5. 新しいウィジェットを長押しし、ウィジェットを編集をタップします。
  6. Scriptを、作成したスクリプトに設定します。
  7. Scriptableのパラメータをすでに使っている場合を除き、他のオプションは初期設定のままにします。
  8. 設定画面の外側をタップします。ホーム画面がまだ編集モードなら、完了をタップします。

ウィジェットに選んだ画像が表示されます。タップすると、SHORTCUT_NAMEに書いた名前のショートカットが実行されます。

ウィジェットスクリプト ​

js
// 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がショートカットアプリの名称と、大文字と小文字、および空白も含めて一致しているか確認します。ショートカット側か定数側の名前を揃え、スクリプトを保存してから、ウィジェットを編集してスクリプトを選び直します。

ウィジェットが空白になる、または古い画像が表示される ​

  1. Scriptable内でスクリプトを1回実行し、保存画像を書き直します。
  2. ウィジェットを長押ししてウィジェットを編集をタップし、正しいスクリプトが選ばれているか確認します。
  3. それでも更新されない場合は、iPadを再起動します。

Scriptableが写真へのアクセスを求める ​

表示されたら、写真へのアクセスを許可します。アプリ内の実行はPhotos.fromLibrary()でウィジェット画像を選びます。

参考リンク ​