リリースノート

# リリースノート

# LIFFのバージョンとリリース日程

LIFF v2.2.0以降、LIFFのバージョンナンバーはセマンティック バージョニング (opens new window)（SemVer）で定められたルールに従います。詳しくは、「バージョニングポリシー」を参照してください。

CDNパス

LIFFでは、CDN固定パスとCDNエッジパスの2種類のCDNパスを用意しています。CDNエッジパスを使用する場合は、常に最新のマイナーバージョンとパッチバージョンに更新されます。CDN固定パスを使用する場合は、新しいバージョンを使用するには、手動でURLを更新する必要があります。

詳しくは、『LIFFドキュメント』の「LIFF SDK（sdk.js）のアップデートポリシー」をご参照ください。

# 現在のバージョン

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を使用する場合は、常にLIFF v2の最新機能を利用できます。

LIFF v2.22.4：2023年10月2日

# バージョンリスト

CDN固定パス（例：https://static.line-scdn.net/liff/edge/versions/2.22.4/sdk.js）を使用する場合は、LIFFの特定のバージョンの機能を利用できます。

2023/10/2

# LIFF v2.22.4をリリースしました

LIFF v2.22.4をリリースしました。

LIFF v2.22.4では、LIFF SDK内部の挙動を変更しました。また、以下の変更と不具合修正を行いました。

2023年10月2日のニュースでお知らせしたとおり、グループ内再編により、LINE株式会社はLINEヤフー株式会社になりました。これに伴い、LIFF SDKと以下のオープンソースプロジェクトにおいて、社名とコピーライトを変更しました。

# liff.permission.requestAll()メソッドの実行が失敗した際に、エラーが正しく渡されない場合がある不具合を修正しました

liff.permission.requestAll()メソッドの実行が失敗した際に、エラーが正しく渡されない場合がある不具合がありました。LIFF v2.22.4では、エラーが正しく渡されるよう不具合を修正しました。

# LIFF v2.22.4へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.22.4にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.22.4もしくはyarn add @line/liff@2.22.4を実行するとv2.22.4にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2023/8/24

# LIFF v2.22.3をリリースしました

LIFF v2.22.3をリリースしました。

LIFF v2.22.3では、LIFF SDK内部の挙動を変更しました。機能の変更はありません。

# LIFF v2.22.3へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.22.3にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.22.3もしくはyarn add @line/liff@2.22.3を実行するとv2.22.3にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2023/6/27

# LIFF v2.22.2をリリースしました

LIFF v2.22.2をリリースしました。

LIFF v2.22.2では、以下の改善や不具合修正を行いました。

# Androidの外部ブラウザにおける自動ログインの処理を改善しました

2022年7月6日にお知らせしたとおり、LIFF v2.20.3より、Androidの外部ブラウザで自動ログインが正しく行われない不具合の暫定対応として、自動ログイン後にアラートを表示するようにしました。

Android版LINEバージョン13.10.0において、外部ブラウザにおける自動ログインの処理が改善されるため、暫定対応が不要となりました。これに伴い、LIFF v2.22.2以降では、自動ログイン後に表示されていたアラートが表示されなくなります。

なお、LIFFアプリのLIFF SDKのバージョンがv2.22.2以降であっても、Android版LINEのバージョンが13.10.0未満の場合は、引き続きアラートが表示されます。

LIFF v2.20.3〜v2.22.1 LIFF v2.22.2以降
Android版LINEバージョン13.10.0未満 アラートを表示する アラートを表示する
Android版LINEバージョン13.10.0以降 アラートを表示する アラートを表示しない

# LIFF SDKのnpmパッケージを非ブラウザ環境でインポートできるようになりました

LIFF SDKのnpmパッケージをNode.jsといった非ブラウザ環境でインポートできるようになりました。

# Androidの外部ブラウザにおいて、liff.login()メソッドのredirectUriプロパティにクエリパラメータのないURLを指定して実行すると、ログイン後に誤ったURLが開かれる不具合を修正しました

Androidの外部ブラウザにおいて、liff.login()メソッドのredirectUriプロパティにクエリパラメータのないURLを指定して実行すると、ログイン後に誤ったURLが開かれる不具合がありました。

LIFF v2.22.2では、ログイン後に正しいURLが開かれるよう、不具合を修正しました。

redirectUriプロパティに指定したURLの例 https://example.com/path
ログイン後に開かれる誤ったURLの例 https://example.com/path&liffIsEscapedFromApp=true
ログイン後に開かれる正しいURLの例 https://example.com/path?liffIsEscapedFromApp=true

# LIFF v2.22.2へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.22.2にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.22.2もしくはyarn add @line/liff@2.22.2を実行するとv2.22.2にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2023/5/24

# LIFF v2.22.1をリリースしました

LIFF v2.22.1をリリースしました。

LIFF v2.22.1では、LIFF SDKのリファクタリングを行いました。また、以下の修正を行いました。

# プラガブルSDKのLIFF APIのモジュールについて、TypeScriptの型定義を修正しました

プラガブルSDKのLIFF APIのモジュールについて、TypeScriptの型定義を修正しました。

TypeScriptの型定義を修正したLIFF APIのモジュールおよび修正内容は以下のとおりです。

LIFF APIのモジュール 修正内容
@line/liff/get-id-token getIdTokenをgetIDTokenに修正しました。
@line/liff/get-decoded-id-token getDecodedIdTokenをgetDecodedIDTokenに修正しました。

# LIFF v2.22.1へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.22.1にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.22.1もしくはyarn add @line/liff@2.22.1を実行するとv2.22.1にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2023/3/29

# LIFF v2.22.0をリリースしました

LIFF v2.22.0をリリースしました。

LIFF v2.22.0では、以下の機能を追加しました。

# LIFF SDKのファイルサイズを最大約34%削減できるプラガブルSDK機能を追加しました

LIFF SDKのnpmパッケージにおいて、LIFF SDKに含めるLIFF APIを選択できる、プラガブルSDK機能を追加しました。

LIFFアプリで利用するLIFF APIのみをLIFF SDKに含めることで、LIFF SDKのファイルサイズを最大約34%削減できます。その結果、LIFFアプリの表示速度を向上させることができます。

# プラガブルSDKの利用方法

まず、liffオブジェクトを@line/liff/coreからインポートします。従来のliffオブジェクトのインポート元である@line/liffと異なる点に注意してください。

import liff from "@line/liff/core";

このliffオブジェクトは従来のliffオブジェクトとは異なり、以下のプロパティとメソッドのみが含まれています。

上記以外のLIFF APIを利用するには、対応するモジュールをインポートします。以下の例では、liff.getOS()メソッドとliff.getLanguage()メソッドに対応するモジュールをインポートしています。

import liff from "@line/liff/core";
import GetOS from "@line/liff/get-os";
import GetLanguage from "@line/liff/get-language";

そして、インポートしたLIFF APIのモジュールをliff.use()メソッドに渡し、LIFF APIを有効化します。LIFF APIのモジュールはクラスで定義されているため、liff.use()メソッドにインスタンスを渡す必要があります。

LIFF APIを有効化すると、LIFF APIを利用できるようになります。

import liff from "@line/liff/core";
import GetOS from "@line/liff/get-os";
import GetLanguage from "@line/liff/get-language";

liff.use(new GetOS());
liff.use(new GetLanguage());

liff.init({
  liffId: "123456-abcedfg",
});

liff.getOS();
liff.getLanguage();

プラガブルSDKについて詳しくは、『LIFFドキュメント』の「プラガブルSDK」を参照してください。

従来のLIFF SDKを利用する

従来のLIFF SDKも引き続き利用できます。利用方法に変更はありません。

// 従来のliffオブジェクト
import liff from "@line/liff";

// プラガブルSDKのliffオブジェクト
import liff from "@line/liff/core";

2022/12/13

# LIFF v2.21.4をリリースしました

LIFF v2.21.4をリリースしました。

# LIFF SDKのnpmパッケージを正式にリリースしました

2020年7月より試験的に公開していた、LIFF SDKのnpmパッケージを正式にリリースしました。

LIFF SDKのバージョンがv2.21.4未満のnpmパッケージについても、今までと同様に利用できます。利用方法の変更はありません。

LIFF SDKのnpmパッケージについて詳しくは、『LIFFドキュメント』の「npmパッケージを利用する」を参照してください。

# LIFF v2.21.4へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.21.4にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.21.4もしくはyarn add @line/liff@2.21.4を実行するとv2.21.4にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/11/10

# LIFF v2.21.3をリリースしました

LIFF v2.21.3をリリースしました。

LIFF v2.21.3では、以下の不具合を修正しました。

# LIFF SDKのnpmパッケージをES moduleとしてインポートするとエラーが発生する不具合を修正しました

LIFF SDKのnpmパッケージをES moduleとしてインポートすると、Uncaught ReferenceError: require is not defined のエラーが発生する不具合がありました。

LIFF v2.21.3では、上記の場合でもエラーが発生しないよう不具合を修正しました。

# LIFF v2.21.3へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.21.3にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.21.3もしくはyarn add @line/liff@2.21.3を実行するとv2.21.3にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/10/12

# LIFF v2.21.2をリリースしました

LIFF v2.21.2をリリースしました。

LIFF v2.21.2では、LIFF SDKの安定性を向上させるためのリファクタリングを行いました。機能の変更はありません。

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.21.2にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.21.2もしくはyarn add @line/liff@2.21.2を実行するとv2.21.2にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/9/5

# LIFF v2.21.1をリリースしました

LIFF v2.21.1をリリースしました。

LIFF v2.21.1では、LIFF SDKのリファクタリングを行いました。機能の変更はありません。

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.21.1にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.21.1もしくはyarn add @line/liff@2.21.1を実行するとv2.21.1にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/8/4

# LIFF v2.21.0をリリースしました

LIFF v2.21.0をリリースしました。

LIFF v2.21.0では、以下の機能追加や改善を行いました。

# LIFF SDKの表示する文言が多言語に対応しました

LIFF SDKの表示する文言が多言語に対応しました。これにより、LIFF SDKの表示する各文言が、navigator.language (opens new window)で取得したユーザーの言語で表示されるようになります。

ただし、現時点では、翻訳が適用されていないため、いずれの文言も英語で表示されます。今後、段階的に翻訳が適用される予定です。

# LIFF SDKが表示する文言の言語を指定できるようになりました

LIFF SDKが表示する文言の言語を指定する、liff.i18n.setLang()メソッドが追加されました。liff.i18n.setLang()メソッドを使うと、ユーザーの言語に関わらず、指定した言語でLIFF SDKの文言を表示できます。

liff.i18n.setLang("en");

なお、翻訳が適用されていない文言は、このメソッドの影響を受けません。

詳しくは、『LIFF APIリファレンス』の「liff.i18n.setLang()」を参照してください。

# liff.init()メソッドが無効なLIFF IDで成功する場合がある不具合を修正しました

liff.init()メソッドが無効なLIFF IDで成功する場合がある不具合がありました。LIFF v2.21.0では、liff.init()メソッドが無効なLIFF LIFF IDで失敗するように修正しました。

# liff.getProfile()メソッドで取得できるプロフィール情報のTypeScriptの型定義を利用できるようになりました

LIFF SDKのnpmパッケージにおいて、liff.getProfile()メソッドで取得できるプロフィール情報のTypeScriptの型定義を利用できるようになりました。@liff/get-profileパッケージからProfile型をインポートできます。

import { Profile } from "@liff/get-profile";

2022/7/6

# LIFF v2.20.3をリリースしました

LIFF v2.20.3をリリースしました。

LIFF v2.20.3では、以下の不具合を修正しました。

# Androidの外部ブラウザで自動ログインが正しく行われない不具合の暫定対応として、自動ログイン後にアラートを表示するようにしました

Androidの外部ブラウザで自動ログインが正しく行われない場合がありました。その暫定対応として、Androidの外部ブラウザにおいて、自動ログイン後に以下のアラートを表示するようにしました。

Login successfully!

なお、今後のLIFF SDKのアップデートでアラートの表示を改善する予定です。

# LIFF v2.20.3へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.20.3にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.20.3もしくはyarn add @line/liff@2.20.3を実行するとv2.20.3にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/6/8

# LIFF v2.20.2をリリースしました

LIFF v2.20.2をリリースしました。

LIFF v2.20.2では、内部的な機能改善を行いました。

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.20.2にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.20.2もしくはyarn add @line/liff@2.20.2を実行するとv2.20.2にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/5/24

# LIFF v2.20.1をリリースしました

2022年5月25日追記

npm側の不具合に起因する、LIFF v2.20.1のnpmパッケージをインストールできない問題が解消いたしました。

詳しくは、npmのステータスページ (opens new window)を参照してください。

LIFF v2.20.1をリリースしました。

LIFF v2.20.1では以下の改善を行いました。

# 外部ブラウザにおいて、未ログイン状態でliff.scanCodeV2()メソッドを実行した際に、エラーを返すようにしました

liff.scanCodeV2()メソッドを実行するには、ユーザーのログインが必要です。

LIFF v2.19.1以前では、外部ブラウザにおいて、未ログイン状態でliff.scanCodeV2()メソッドを実行すると、サブウィンドウが開かれ、空白ページが表示されていました。また、Promiseはpendingのままとなっていました。

LIFF v2.20.1では、上記の場合に、サブウィンドウが開かれなくなりました。また、Promiseがrejectされ、LiffErrorが渡されるようになりました。

liff.scanCodeV2()メソッドについて詳しくは、『LIFF APIリファレンス』の「liff.scanCodeV2()」を参照してください。

LIFF v2.20.0は非推奨です

Androidにおいて、外部ブラウザを使用しているユーザーの一部がログインできない不具合があったため、LIFF v2.20.0は非推奨となりました。LIFF v2.20.0を利用している場合は、LIFF v2.20.1へアップデートしてください。

2022/4/18

# LIFF v2.19.1をリリースしました

2022年4月25日追記

近日公開予定としておりました、LIFF InspectorとLIFF Mockを本日リリースしました。詳しくは、2022年4月25日のニュース、「LIFF InspectorとLIFF Mockをリリースしました」を参照してください。

LIFF v2.19.1をリリースしました。

LIFF v2.19.1では以下の機能追加を行いました。

# LIFF SDKを拡張できるLIFFプラグイン機能を追加しました

昨年11月に開催された、LINE DEVELOPER DAY 2021のセッション「すべてのLIFFアプリ開発者の開発体験を向上させるために (opens new window)」でご紹介した、LIFFプラグイン機能を追加しました。

LIFFプラグインとは、LIFF SDKを拡張できる機能です。LIFFプラグインを使うと、LIFF SDKに独自のAPIを追加したり、LIFF APIの挙動を変更したりできます。

また、近日公開予定としておりました、以下のLIFFプラグインをご利用いただけるようになりました。

# LIFF Inspector

LIFF Inspectorは、LIFFアプリをデバッグするためのLIFFプラグインです。LIFF Inspectorを使うと、LIFFアプリを実行している端末とは別のPC上のChrome DevTools (opens new window)を使って、LIFFアプリをデバッグできます。

# LIFF Mock

LIFF Mockは、LIFFアプリのテストを簡単にするためのLIFFプラグインです。LIFF Mockを使うと、LIFF SDKにモックモードを追加できます。モックモードでは、LIFFアプリがLIFFサーバーから独立し、LIFF APIがモックデータを返すため、単体テストや負荷テストをより簡単に行うことができます。

LIFFプラグインについて詳しくは、『LIFFドキュメント』の「LIFFプラグイン」を参照してください。

2022/3/22

# LIFF v2.19.0をリリースしました

LIFF v2.19.0をリリースしました。

LIFF v2.19.0では、内部的な機能改善を行いました。

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.19.0にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.19.0もしくはyarn add @line/liff@2.19.0を実行するとv2.19.0にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2022/2/14

# LIFF v2.18.2をリリースしました

LIFF v2.18.2をリリースしました。

LIFF v2.18.2では以下の改善を行いました。

# iOS版およびiPadOS版LINEバージョン12.0.0でLINEのアップデートを促すアラートを表示するようにしました

2022年1月14日にお知らせしたとおり、iOS版およびiPadOS版LINEバージョン12.0.0において、特定の条件下でliff.sendMessages()メソッドが正常に動作せず、ステータスコード403のエラーが発生する不具合がありました。この不具合は、ユーザーが利用しているLINEのバージョンを12.0.1以降にアップデートすることで解消します。

ユーザーに修正バージョンのLINEへのアップデートを促すため、iOS版およびiPadOS版LINEバージョン12.0.0において、liff.sendMessages()メソッド実行時にステータスコード403のエラーが発生した場合、アラートを表示するようにしました。

表示されるアラートは以下のとおりです。

LINEアプリをLINE 12.0.1以降にアップデートしてください。Please update your LINE app to LINE 12.0.1 or later.

# liff.scanCodeV2()メソッドでUTF-8エンコーディングの二次元コードを読み取ると、結果が文字化けする不具合を修正しました

liff.scanCodeV2()メソッドでUTF-8エンコーディングの二次元コードを読み取ると、結果が文字化けする不具合を修正しました。

この不具合の修正は、すべてのLIFFアプリに自動的に適用されるため、LIFF SDKのアップデートやコードの改修など、LIFFアプリ側の対応は不要です。

liff.permanentLink.createUrlBy()メソッドにパーセントエンコード (opens new window)されたパスを含むURLを渡すと、不正なパーマネントリンクが返ったり、ステータスコード500のエラーが発生したりする不具合を修正しました。

この不具合の修正は、すべてのLIFFアプリに自動的に適用されるため、LIFF SDKのアップデートやコードの改修など、LIFFアプリ側の対応は不要です。

# LIFF v2.18.2へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.18.2にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.18.2もしくはyarn add @line/liff@2.18.2を実行するとv2.18.2にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/12/21

# LIFF v2.18.1をリリースしました

LIFF v2.18.1では以下の不具合を修正しています。

# TypeScriptでビルド時にエラーが出る不具合を修正しました

LIFF v2.18.0において、メッセージオブジェクトの中にURIアクションが含まれたコードを、TypeScriptでビルドした時にエラーとなる不具合を修正しました。

# 対象メソッド

2021/12/9

# LIFF v2.18.0をリリースしました

LIFF v2.18.0では以下の機能追加を行いました。

LIFFアプリの任意のページのパーマネントリンクを取得するliff.permanentLink.createUrlBy()メソッドが追加されました。

従来のliff.permanentLink.createUrl()メソッドでは、現在のページ以外のパーマネントリンクを取得できませんでした。liff.permanentLink.createUrlBy()メソッドでは、現在のページに加えて、LIFFアプリの任意のページのパーマネントリンクを取得できるようになりました。

また、従来のliff.permanentLink.createUrl()メソッドでは、任意のクエリパラメータを追加したパーマネントリンクを取得するには、あらかじめliff.permanentLink.setExtraQueryParam()メソッドを実行する必要がありました。liff.permanentLink.createUrlBy()メソッドでは、メソッド実行時に追加したいクエリパラメータを指定できます。また、liff.permanentLink.createUrlBy()メソッドは、liff.permanentLink.setExtraQueryParam()メソッドの影響を受けません。

liff.permanentLink.createUrl() liff.permanentLink.createUrlBy()
パーマネントリンクを取得できるLIFFアプリのページ 現在のページ 任意のページ
パーマネントリンクへの任意のクエリパラメータの追加方法 あらかじめliff.permanentLink.setExtraQueryParam()メソッドを実行する liff.permanentLink.createUrlBy()メソッド実行時に指定する
戻り値 文字列 Promiseオブジェクト
// For example, if the endpoint URL of the LIFF app is https://example.com/path1?q1=v1
// and its LIFF ID is 1234567890-AbcdEfgh
liff.permanentLink
  .createUrlBy("https://example.com/path1?q1=v1")
  .then((permanentLink) => {
    // https://liff.line.me/1234567890-AbcdEfgh
    console.log(permanentLink);
  });

liff.permanentLink
  .createUrlBy("https://example.com/path1/path2?q1=v1&q2=v2")
  .then((permanentLink) => {
    // https://liff.line.me/1234567890-AbcdEfgh/path2?q=2=v2
    console.log(permanentLink);
  });
liff.permanentLink.createUrl()メソッドは次回メジャーバージョン以降に非推奨になる可能性があります

技術的な問題があり、liff.permanentLink.createUrl()メソッドは、次回メジャーバージョン以降に非推奨になる可能性があります。現在のページのパーマネントリンクを取得するには、liff.permanentLink.createUrlBy()メソッドを使用することをお勧めします。

詳しくは、『LIFF APIリファレンス』の「liff.permanentLink.createUrlBy()」を参照してください。

2021/11/11

# LIFF v2.17.0をリリースしました

LIFF v2.17.0では以下の不具合を修正しました。

# iOS版LINEでliff.openWindow()メソッドを実行すると、URLフラグメントの末尾に意図しないクエリパラメータが追加されたURLが開かれる不具合を修正しました

iOS版LINEでliff.openWindow()メソッドを実行するとき、urlプロパティにクエリパラメータが含まれず、かつURLフラグメントが含まれていると、URLフラグメントの末尾に意図しないクエリパラメータが追加されたURLが開かれる不具合がありました。

LIFF v2.17.0では、上記の場合でも正しいURLを開くように不具合を修正しました。

# liff.openWindow()メソッド実行時に開かれるURLの例

LIFF SDKバージョン urlプロパティ 開かれるURL
v2.16.1 https://example.com#URL-fragment https://example.com#URL-fragment?is_liff_external_open_window=false
v2.17.0 https://example.com#URL-fragment https://example.com#URL-fragment

liff.openWindow()メソッドについて詳しくは、『LIFF APIリファレンス』の「liff.openWindow()」を参照してください。

2021/10/26

# LIFF v2.16.1をリリースしました

LIFF v2.16.1では以下の不具合を修正しています。

# LIFF v2.14.0以降のCDN版のファイルサイズが肥大化する不具合を修正しました

LIFF v2.14.0で行われた内部的なソースコードの変更により、LIFF v2.14.0以降のCDN版のファイルサイズが肥大化する不具合がありました。LIFF v2.16.1では、ファイルサイズの肥大化が起こらないよう、不具合を修正しました。

# webpack v5を使ったプロジェクトのビルド時にエラーが発生する不具合を修正しました

webpack v5から、Node.jsのポリフィルが削除されました。 (opens new window)その影響により、webpack v5を使ったプロジェクトでLIFF v2.16.0以前のnpm版を使用すると、ビルド時にエラーが発生し、以下のようなメッセージが表示されます。

Module not found: Error: Can't resolve 'crypto' in 'node_modules/js-crypto-env/dist'

BREAKING CHANGE: webpack < 5 used to include polyfills for node.js core modules by default.
This is no longer the case. Verify if you need this module and configure a polyfill for it.

If you want to include a polyfill, you need to:
- add a fallback 'resolve.fallback: { "crypto": require.resolve("crypto-browserify") }'
- install 'crypto-browserify'
If you don't want to include a polyfill, you can use an empty module like this:
resolve.fallback: { "crypto": false }

これは、LIFF v2.16.0以前では、LIFF SDK内部においてNode.jsのポリフィルに依存した実装をしているためです。LIFF v2.16.1では、Node.jsのポリフィルに依存しない実装に変更されたため、上記のエラーが発生しなくなりました。

# webpack v5を使ったプロジェクトでLIFF v2.16.0以前のnpm版を使う場合

LIFF SDKのバージョンを維持したまま不具合を修正するには、Node.jsのポリフィルのインストールと、webpack.config.jsの設定が必要です。

まず、Node.jsのポリフィルをインストールします。crypto-browserify と stream-browserify をインストールしてください。

# npmの場合
$ npm install crypto-browserify stream-browserify

# Yarnの場合
$ yarn add crypto-browserify stream-browserify

次に、webpack.config.jsのresolve.fallbackを以下のようにします。

module.exports = {
  resolve: {
    fallback: {
      crypto: require.resolve("crypto-browserify"),
      stream: require.resolve("stream-browserify"),
    },
  },
};

# LIFF v2.16.1へのアップデート方法

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.16.1にアップデートされています。

npmパッケージを利用している場合は、npm install @line/liff@2.16.1もしくはyarn add @line/liff@2.16.1を実行するとv2.16.1にアップデートされます。

LIFF SDKの組み込み方法について詳しくは、「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/10/12

# LIFF v2.16.0をリリースしました

LIFF v2.16.0では以下の機能追加を行いました。

# シェアターゲットピッカーに、送信先を複数にするか1人にするかを制御するオプションが追加されました

liff.shareTargetPicker()メソッドにisMultipleプロパティが追加されました。isMultipleプロパティを設定することで、ユーザーがターゲットピッカーで選択できるメッセージ送信先として、複数の送信先を選択可能にするかどうかを制御できるようになりました。

isMultipleプロパティにtrueを指定した場合は、ユーザーはターゲットピッカーで複数の送信先を選択可能です。falseを指定した場合は、送信先として友だち1人だけを選択可能です。デフォルトではtrueが指定されます。

isMultipleの値 選択可能な送信先 選択可能な件数
true グループ、友だち、トーク 複数の送信先を選択可能
false 友だち 1人だけ選択可能
isMultipleにfalseを設定しても、1人の友だちのみにメッセージが送信されることは保証できません

isMultipleプロパティにfalseを設定しても、シェアターゲットピッカーを複数回呼び出すことや、シェア後のメッセージをユーザー側で再度シェアすることで、複数のユーザーへのメッセージ送信が可能です。厳密にユーザーから1人の友だちに対して、一度しかメッセージを送信できないようにする場合には、LIFFアプリ実装時に制限をかける必要があります。

URLを含むメッセージを送信し、URLへのアクセスを制限する場合の例を紹介します。

  1. URLにユニークなトークンを付与し、メッセージを送信します。
  2. メッセージ内のURLへアクセスされた際にサーバー側でトークンを検証し、複数のユーザーからのアクセスを制限します。
ユーザーがシェアターゲットピッカーでメッセージを送信した人数は、取得できません

ユーザーのプライバシーを保護するため、シェアターゲットピッカーで、何人にメッセージが送信されたかの情報は取得できません。また、提供も行なっておりません。

liff.shareTargetPicker()メソッドにisMultipleプロパティを追加したサンプルコード：

if (liff.isApiAvailable("shareTargetPicker")) {
  liff
    .shareTargetPicker(
      [
        {
          type: "text",
          text: "Hello, World!",
        },
      ],
      {
        isMultiple: true,
      }
    )
    .then(function (res) {
      if (res) {
        // succeeded in sending a message through TargetPicker
        console.log(`[${res.status}] Message sent!`);
      } else {
        const [majorVer, minorVer] = (liff.getLineVersion() || "").split(".");
        if (parseInt(majorVer) == 10 && parseInt(minorVer) < 11) {
          // LINE 10.3.0 - 10.10.0
          // Old LINE will access here regardless of user's action
          console.log(
            "TargetPicker was opened at least. Whether succeeded to send message is unclear"
          );
        } else {
          // LINE 10.11.0 -
          // sending message canceled
          console.log("TargetPicker was closed!");
        }
      }
    })
    .catch(function (error) {
      // something went wrong before sending a message
      console.log("something wrong happen");
    });
}

詳しくは、『LIFF APIリファレンス』の「liff.shareTargetPicker()」を参照してください。

2021/10/01

# 2021年10月1日をもってLIFF v1を廃止しました

2021年9月17日にお知らせしたとおり、LIFF v1を2021年10月1日に廃止いたしました。

なお、サーバーAPIにつきましては、LIFF v1とは異なるスケジュールで管理されているため、今回の廃止対象ではありません。

# 対象バージョン

LIFF v1

LIFF v1をお使いの場合はLIFF v2へ移行してください

LIFF v2への移行について詳しくは、2021年4月5日にお知らせした「LIFF v2に移行する」を参照してください。

# 廃止日

2021年10月1日

# 影響

今後、LIFF v1 SDKのURL（https://d.line-scdn.net/liff/1.0/sdk.js）の参照、およびLIFF v1 APIの利用が順次できなくなります。

2021/09/30

# LIFF v2.15.0をリリースしました

LIFF v2.15.0では以下の機能追加を行いました。

# 二次元コードリーダー機能が追加されました

LIFFアプリ上で二次元コードリーダーを起動するliff.scanCodeV2()メソッドが追加されました。

従来のliff.scanCode()は技術的な問題があり、iOS版LINEバージョン9.19.0以降や外部ブラウザでは使用できませんでしたが、liff.scanCodeV2()では最新のiOS版LINEや外部ブラウザでも二次元コードリーダーを起動できるようになりました。

liff.scanCodeV2()の動作仕様

liff.scanCodeV2()は、内部でjsQR (opens new window)という外部ライブラリを使用しています。そのため、liff.scanCodeV2()メソッド実行時に起動する二次元コードリーダーは、jsQR (opens new window)の動作仕様に依存します。なお、使用ライブラリは予告なく更新、変更される可能性があります。

liff.scanCode()メソッドは非推奨です

従来のliff.scanCode()メソッドは非推奨になります。二次元コードリーダーを実装する場合は、liff.scanCodeV2()メソッドを使用することをお勧めします。

# liff.scanCodeV2()による二次元コードリーダーの実装

liff.scanCodeV2()を使った二次元コードリーダーの実装方法は、従来のliff.scanCode()と同様です。LINE DevelopersコンソールのLIFFタブで［Scan QR］をオンにした上で、以下のようにliff.scanCodeV2()を実装してください。


# liff.scanCodeV2()のサンプルコード：
liff.scanCodeV2().then((result) => {
  // result = { value: "" }
});
LINEミニアプリによる二次元コードリーダーのサポートは2021年10月7日を予定しています

liff.scanCodeV2()を使って二次元コードリーダーを起動するには、LINE DevelopersコンソールのLINEログインチャネルのLIFFタブで［Scan QR］をオンにする必要があります。LINEミニアプリチャネルへの［Scan QR］設定の追加は2021年10月7日を予定しています。2021年9月30日現在、LINEミニアプリではliff.scanCodeV2()は利用できません。

Scan QR

# liff.scanCodeV2()メソッドの動作環境

liff.scanCodeV2()メソッドの動作環境と、表示される二次元コードリーダーは以下のとおりです。

# 動作環境

従来のliff.scanCode()メソッドは技術的な問題があり、iOS版LINEバージョン9.19.0以降または外部ブラウザでは利用できませんでした。今回追加されたliff.scanCodeV2()メソッドは最新のiOS版LINEや外部ブラウザでも利用できるようになりました。

OS バージョン LINEアプリのバージョン 外部ブラウザ
9.18.0以前 9.19.0〜11.6.x 11.7.0以降
iOS 11〜14.2 ❌ ❌ ❌ ✅ ※1
14.3以降 ❌ ❌ ✅ ※2 ✅ ※1
Android すべてのバージョン ❌ ❌ ✅ ※2 ✅ ※1
PC すべてのバージョン ❌ ❌ ❌ ✅ ※1

※1 WebRTC API (opens new window)をサポートするブラウザのみ利用できます。

※2 LIFFブラウザの画面サイズがFullの場合のみ利用できます。詳しくは、『LIFFドキュメント』の「LIFFブラウザの画面サイズ」を参照してください。

# 二次元コードリーダー

liff.scanCode()メソッドの場合、AndroidとiOSでは表示される二次元コードリーダーが異なりましたが、liff.scanCodeV2()メソッドの場合、OSの違いによらず以下の画面に統一されます。

二次元コードリーダー

二次元コードリーダーを起動すると、FullサイズのLIFFアプリの画面下部からTallサイズのサブウィンドウが表示されます。また、画面右下の 二次元コード選択 アイコンをクリックすると、読み取り対象の二次元コードを写真から選ぶことができます。


liff.scanCodeV2()を使った二次元コードリーダーの実装について詳しくは、『LIFFドキュメント』の「二次元コードリーダーを表示する」を参照してください。

# 外部ブラウザでLIFFアプリ初期化時にliff.login()メソッドが自動で実行されるオプションが追加されました

liff.init()メソッドにwithLoginOnExternalBrowserプロパティが追加されました。通常、外部ブラウザでLIFFアプリにアクセスする場合、liff.login()メソッドで明示的にログイン処理を行う必要があります。今回追加されたwithLoginOnExternalBrowserプロパティにtrueを指定することで、LIFFアプリ初期化時（liff.init()メソッド実行時）にliff.login()メソッドを自動で実行することができるようになりました。

ログイン

liff.init()メソッドにwithLoginOnExternalBrowserプロパティを追加したサンプルコード：

liff.init({
  liffId: "123456-abcdef",
  withLoginOnExternalBrowser: true, // Enable automatic login process
}).then(() =>
  // Start to use liff's api
});

詳しくは、『LIFF APIリファレンス』の「liff.init()」を参照してください。

2021/09/17

# 2021年10月1日をもってLIFF v1を廃止します

2021年4月5日にお知らせしたとおり、LIFF v1は非推奨期間を終了し、2021年10月1日に廃止いたします。

# 対象バージョン

LIFF v1

LIFF v1をお使いの場合はLIFF v2へ移行してください

LIFF v2への移行について詳しくは、2021年4月5日にお知らせした「LIFF v2に移行する」を参照してください。

# 廃止日

2021年10月1日

# 影響

2021年10月1日以降、LIFF v1 SDKのURL（https://d.line-scdn.net/liff/1.0/sdk.js）の参照、およびLIFF v1 APIの利用が順次できなくなります。

2021/09/14

# LIFF v2.14.0をリリースしました

今回のバージョンアップでは、SDK内部のリファクタリングのみで、機能の変更はありません。

2021/08/12

# LIFF v2.13.0をリリースしました

LIFF v2.13.0では以下の機能追加と不具合の修正を行いました。

本日（2021年8月12日）リリースされた「チャネル同意の簡略化」機能を利用する場合、対象のLINEミニアプリのLIFF SDKをv2.13.0にバージョンアップする必要があります。

「チャネル同意の簡略化」機能を使用すると、ユーザーが初めてLINEミニアプリにアクセスした際に表示される「同意画面」をスキップできるようになります。

LIFF SDKのバージョン以外の利用条件や、動作、設定方法など詳しくは、『LINEミニアプリドキュメント』の「同意画面のプロセスをスキップする」を参照してください。

# npmパッケージ版LIFF SDKの一部不具合を修正しました

npmパッケージ版内部の一部不具合を修正しました。

npmパッケージを利用している場合は、npm install @line/liff@2.13.0もしくはyarn add @line/liff@2.13.0を実行してv2.13.0にバージョンアップすることをお勧めします。

LIFF SDKの組み込み方法について詳しくは、「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/07/12

# LIFF v2.12.0をリリースしました

LIFF v2.12.0では、SDK内部の挙動の変更のみで、機能の変更はありません。

2021/06/24

# LIFF v2.11.1をリリースしました

LIFF v2.11.1では以下の不具合を修正しています。

# LIFFアプリ初期化後にURLフラグメントがURLエンコードされる不具合を修正しました

LIFF v2.11.0では、URLフラグメント（例：#url-fragment）を含むLIFF URLにアクセスした際に、LIFFアプリ初期化後（liff.init()実行後）にURLフラグメントがURLエンコードされる不具合がありました。

LIFF v2.11.1では、liff.init()後もURLフラグメントがURLエンコードされないように不具合を修正しました。

# liff.init()後のURLフラグメントの例

以下の例では、LIFF v2.11.0はliff.init()後に、URLフラグメント（#url/fragment）内のスラッシュ（/）がURLエンコード（%2F）されています。

LIFFバージョン LIFF URL liff.init()後のURL
v2.11.0 https://liff.line.me/{liffId}#url/fragment https://liff.line.me/{liffId}#url%2Ffragment
v2.11.1 https://liff.line.me/{liffId}#url/fragment https://liff.line.me/{liffId}#url/fragment
LIFF v2.11.1へのアップデートをおすすめします

LIFF v2.11.0を利用したLIFFアプリの場合、ブラウザの種類（LIFFブラウザ、LINE内ブラウザ、外部ブラウザ）に限らず本不具合が発生します。また、LIFF URL（例：https://liff.line.me/{liffId}/#url/fragment）だけでなく、エンドポイントURL（例：https://example.com/#url/fragment）に直接アクセスした場合も同様に本不具合が発生します。

意図しない挙動を避けるため、LIFF v2.11.0を利用している場合は、v2.11.1へのアップデートをおすすめします。

LIFF SDKの組み込み方法について詳しくは、「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/06/14

# LIFF v2.11.0をリリースしました

LIFF v2.11.0では、セキュリティ上の観点から以下の修正を行いました。

# liff.init()後に一次リダイレクト先URLから機密情報が除外されるようになりました

セキュリティ上の観点から、liff.init()がresolveされたタイミングで、一次リダイレクト先URLからアクセストークンなどの機密情報を含むURLフラグメントが除外されるようになりました。そのため、メソッドチェーンのthen()メソッド内の処理では、機密情報を含まない一次リダイレクト先URLが現在のURLとして扱われます。

# リダイレクトの例

LIFF URLがhttps://liff.line.me/{liffId}/pathで、エンドポイントURLがhttps://example.comだった場合、以下のようにリダイレクトされます。

機密情報が除外されるタイミング

番号 項目 URL
① LIFF URL https://liff.line.me/{liffId}/path
② 一次リダイレクト先URL https://example.com/?liff.state=path
#access_token=xxx&context_token=xxx&
feature_token=xxx&id_token=xxx&client_id=xxx
③ liff.init()後のURL https://example.com/?liff.state=path
④ 二次リダイレクト先URL https://example.com/path

# liff.init()時のサンプルコード

liff.init().then()メソッド内では、機密情報が除外されます。

console.log(window.location.href);
// https://example.com/?liff.state=path#access_token=xxx&context_token=xxx&feature_token=xxx&id_token=xxx&client_id=xxx

liff.init({ liffId: myLiffId }).then(() => {
  console.log(window.location.href);
  // https://example.com/?liff.state=path
});
Google Analyticsなど外部のロギングツールの利用について

Google Analyticsなど外部のロギングツールを利用する場合は、LIFFアプリにアクセスしたユーザーの機密情報をよりセキュアに管理するために、LIFF v2.11.0へのアップデートをお勧めします。ロギングツールへは、機密情報を含まないliff.init()実行後のURLを送るようにしてください。

liff.init({ liffId: myLiffId }).then(() => {
  ga("send", "pageview");
});

LIFF SDKの組み込み方法について詳しくは、「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/05/17

# LIFF v2.10.0をリリースしました

LIFF v2.10.0では、以下の不具合が修正されました。機能に変更はありません。

# 外部ブラウザでLIFFアプリ初期化時に古いコンテキストトークンが参照される不具合を修正しました

外部ブラウザで、LIFF v2.9.1以前のLIFFアプリにログインした際、以前のセッションでLIFFアプリ初期化時（liff.init()実行時）にlocalStorageに保存された古いコンテキストトークンを参照してしまい、予期しない動作になる不具合を修正しました。

コンテキストトークンとは

コンテキストトークンとは、画面サイズやユーザーIDなど、liff.getContext()メソッドで取得可能なLIFFアプリを起動している環境に関する情報を保有するトークンを指します。LIFFアプリ初期化時（liff.init()メソッド実行時）に、contextキーとして、ブラウザのlocalStorageに保存されます。

# アクセストークンの有効期限を確認するタイミングの見直し

LIFFアプリの初期化時（liff.init()実行時）には、以前のセッションで生成したアクセストークンの有効期限を確認し、期限が切れている場合はコンテキストトークンを破棄する処理が実行されます。しかしLIFF v2.9.1以前のバージョンでは、有効期限の確認処理がLIFFアプリ初期化処理の末尾の段階で実行されるため、破棄されていない古いコンテキストトークンを参照して初期化処理が進行してしまい、予期しない動作になる場合がありました。

LIFF v2.10.0では、アクセストークンの有効期限を確認する処理の順序を、LIFFアプリの初期化処理の初めの方に変更したことにより、古いコンテキストトークンを破棄したうえで初期化処理を行えるようになりました。

liff.getContext()メソッドで取得する情報が最新であることは保証されません

コンテキストトークンは、アクセストークンの有効期限が切れたタイミングで破棄されます。LIFF v2.10.0であってもアクセストークンが有効期限内である限り、liff.getContext()メソッドで取得できるコンテキスト情報は変わりません。そのため、liff.getContext()メソッドで取得する情報が常に最新であることは保証されません。

# バージョンごとのコンテキストトークン破棄のタイミング

以下は、LIFF v2.9.1以前とLIFF v2.10.0のアクセストークンの有効期限の確認と、コンテキストトークン破棄のタイミングの比較です。

LIFFのバージョン コンテキストトークンがlocalStorageに保存される流れ
v2.9.1以前 以前のコンテキストトークン破棄のタイミング
v2.10.0 v2.10.0以降のコンテキストトークン破棄のタイミング
LIFFブラウザおよびLINE内ブラウザの場合

LIFFブラウザおよびLINE内ブラウザでは、今回のバージョンアップによる影響は受けません。

コンテキストトークンが保有する情報について詳しくは、『LIFF APIリファレンス』の「liff.getContext()」を参照してください。

2021/04/27

# LIFF v2.9.1をリリースしました

LIFF v2.9.1では、以下の不具合が修正されました。機能に変更はありません。

# LIFF SDKのnpmパッケージ利用時の不具合を修正しました

LIFF SDKのnpmパッケージをTypeScriptで利用しようとすると、コンパイル時にエラーが発生する不具合を修正しました。LIFF v2.9.1ではTypeScript利用時でも問題なくコンパイルされます。

なお、今回の修正はnpm版とCDN版両方のLIFF SDKに適用されます。

LIFF SDKのnpmパッケージに関して詳しくは、「npmパッケージを利用する」を参照してください。

コンパイル時のエラーの対処方法

TypeScript利用時のコンパイルエラーの対処方法としてLIFF v2.9.1へのアップグレードを推奨いたしますが、アップグレードができない場合、以下の方法でコンパイルエラーを解消できます。

tsconfig.jsonなどのTypeScriptの設定ファイルでskipLibCheck (opens new window)オプションを有効化するとコンパイルエラーが発生しません。

2021/04/13

# LIFF v2.9.0をリリースしました

LIFF v2.9.0では、SDK内部の挙動の変更のみで、機能の変更はありません。

2021/03/16

# LIFF v2.8.1をリリースしました

今回のバージョンアップでは、SDK内部のリファクタリングのみで、機能の変更はありません。

2021/02/15

# LIFF v2.8.0をリリースしました

LIFF v2.8.0では以下の不具合を修正しています。

機能の変更および追加はありません。

# liff.init()が2次リダイレクト先URLにリダイレクトする前にresolveされる不具合を修正しました

LIFF v2.7.1以前のバージョンでは、2次リダイレクト先URLにリダイレクトする前に、liff.init()がresolveされる不具合がありました。この不具合により、then()メソッドの処理が、2次リダイレクト先URLへのリダイレクト前後に重複して実行されることがありました。

以下のコード例では、2次リダイレクト先URLへのリダイレクト前後に、liff.init()が一度ずつresolveされるため、「liff.init() is resolved.」というアラートが二度表示されます。

liff.init()がresolveされたらアラートを表示するコード例：

liff.init(myLiffId).then(() => {
  // This process is executed after liff.init() is resolved.
  window.alert("liff.init() is resolved.");
});

LIFF v2.8.0では、2次リダイレクト先URLにリダイレクトされた時点で初めてliff.init()がresolveされるため、then()メソッドの処理が重複して実行される不具合は修正されています。上記のコード例では、一度のみアラートが表示されます。

LIFFのバージョン liff.init()がresolveされるタイミング
v2.7.1以前 resolve-timing-v2-7-0
v2.8.0 resolve-timing-v2-8-0

# URLエンコードされたクエリパラメータが意図せずデコードされる不具合を修正しました

LIFF v2.7.1以前のバージョンでは、開発者がLIFF URLにURLエンコードしたクエリパラメータ（例：?t=http%3A%2F%2Fexample.com）を付与した場合、リダイレクト時にクエリパラメータ部分がデコード（例：?t=http://example.com）されていました。そのため、2次リダイレクト先URLが開発者の意図しないURLになる場合がありました。

LIFF v2.8.0では、クエリパラメータはデコードされず、URLエンコードされたままリダイレクトされるように修正されています。

LIFF URL「https://liff.line.me/{liffId}?t=http%3A%2F%2Fexample.com」を開いた時のリダイレクトの流れ：

LIFFのバージョン 1次リダイレクト先URL 2次リダイレクト先URL
v2.7.1以前 https://endpoint.example.jp/?liff.state=
?t=http%3A%2F%2Fexample.com		 https://endpoint.example.jp/
?t=http://example.com
v2.8.0 https://endpoint.example.jp/?liff.state=
%3Ft%3Dhttp%253A%252F%252Fexample.com		 https://endpoint.example.jp/
?t=http%3A%2F%2Fexample.com
クエリパラメータを含むLIFF URLの場合

URLエンコードされたクエリパラメータを含むLIFF URLを利用している場合は、意図しないURLへリダイレクトされることを防ぐため、v2.8.0へのバージョンアップをおすすめします。

LIFFアプリのリダイレクトについて詳しくは、『LIFFドキュメント』の「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2021/01/20

# LIFF v2.7.1をリリースしました

LIFF v2.7.1では、以下の変更が適用されました。

# LIFF v2.7.0を使ったLIFFアプリが外部ブラウザで起動できない場合がある不具合を修正しました

LIFF v2.7.0を使ったLIFFアプリを外部ブラウザで開くと、起動に失敗する場合がある不具合を修正しました。LIFF v2.7.1では、外部ブラウザでも正しくLIFFアプリが起動します。

すでにLIFF v2.7.0をご利用の場合

すでにLIFF v2.7.0を利用している場合は、LIFF v2.7.1へのアップデートをお勧めします。

CDNエッジパス（https://static.line-scdn.net/liff/edge/2/sdk.js）を利用している場合は、自動でv2.7.1にアップデートされます。CDN固定パスやnpmパッケージ版のLIFF SDKを利用している場合は、手動でLIFF v2.7.1にアップデートしてください。

LIFF SDKの組み込み方法の種類について詳しくは、「LIFFアプリにLIFF SDKを組み込む」を参照してください。

2021/01/14

# LIFF v2.7.0をリリースしました

LIFF v2.7.0では、以下の変更が適用されました。

# RequireJSからnpmパッケージ版LIFF SDKを参照できるようになりました

RequireJS (opens new window)からnpmパッケージ版LIFF SDKを参照できるようになりました。

npmパッケージ版のLIFF SDKの組み込み方法は、『LIFFドキュメント』の「LIFFアプリにLIFF SDKを組み込む」を参照してください。

# liff.getDecodedIDToken()メソッドで取得したIDトークンのnameプロパティが文字化けする不具合を修正しました

LIFF v2.6.0以前のバージョンでは、liff.getDecodedIDToken()メソッドでデコード済みのIDトークンを取得した際に、ユーザー名に日本語など、アスキー文字以外のユニコード文字が含まれている場合、nameプロパティの値が文字化けする不具合がありました。

LIFF v2.7.0では不具合を修正し、日本語などユニコード文字で書かれたユーザー名も正しく取得できるようになりました。

ユーザー名がコニーのユーザーのIDトークンを取得した場合：

user profile of conny

LIFF v2.6.0以前 LIFF v2.7.0
 
{
"iss": "https://access.line.me",
"sub": "U272cada9c6f4c0c933b0713bc2f90f68",
"aud": "1234567890",
"exp": 1513142487,
"iat": 1513138887,
"name": "コニー", //文字化けします。
"picture": "https://profile.line-scdn.net/..."
}
 
{
"iss": "https://access.line.me",
"sub": "U272cada9c6f4c0c933b0713bc2f90f68",
"aud": "1234567890",
"exp": 1513142487,
"iat": 1513138887,
"name": "コニー", //正しく取得できます。
"picture": "https://profile.line-scdn.net/..."
}

liff.getDecodedIDToken()メソッドについて詳しくは、『LIFF APIリファレンス』の「liff.getDecodedIDToken()」を参照してください。

2020/12/01

# LIFF v2.6.0をリリースしました

LIFF v2.6.0では、SDK内部の挙動の変更のみで、機能の変更はありません。

2020/10/29

# LIFF v2.5.0をリリースしました

LIFF v2.5.0では、以下の変更が適用されました。

機能の変更はありません。

# liff.init()のパフォーマンスの向上

liff.init()を実行してからLIFFアプリの初期化が完了するまでの速度が改善されました。LIFFアプリを開く際の待ち時間が減少するため、より快適なユーザー体験を提供できます。

liff.init()について詳しくは、『LIFF APIリファレンス』の「liff.init()」を参照してください。

# セキュリティの強化を実施しました

未知の攻撃に対する予防策として、セキュリティ強化を実施しました。

アップデートの必要性について

軽微なセキュリティ強化のため、アップデートは必須ではありません。

2020/09/28

# LIFF v2.3.3をリリースしました

LIFF v2.3.3では以下の不具合を修正しています。

機能の変更はありません。

# エンドポイントURLの末尾が/の場合に意図しないURLへリダイレクトされる不具合を修正しました

以下の条件の時、LIFF URLにアクセスするとパス区切りが二重（//）になり、意図しないURLへリダイレクトされる不具合がありました。

  • ［エンドポイントURL］に指定したURL中にパスが含まれており、かつ末尾が/になっている（例：https://example.com/campaign/）
  • ［LIFF URLの追加情報の処理方法］が［連結］に設定されている
  • LIFF URLにパス（/path）が含まれている（例：https://liff.line.me/{liffId}/path）

LIFF v2.3.3では、上記の条件の場合でも正しいURLへリダイレクトされるように不具合を修正しています。

項目 LIFF URL 1次リダイレクト先 2次リダイレクト先
変更前 https://liff.line.me/{liffId}/path https://example.com/campaign/?liff.state={urlEncode(/path)} https://example.com/campaign//path
変更後 https://liff.line.me/{liffId}/path https://example.com/campaign?liff.state={urlEncode(path)} https://example.com/campaign/path
他のバージョンへの影響
  • LIFF v2.3.xをお使いの場合は、本パッチバージョンへのアップデートをお勧めします。
  • この不具合はLIFF v2.4.1では、すでに修正されています。

LIFF URLへのアクセス時の動作について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2020/09/24

# LIFF v2.4.1をリリースしました

LIFF v2.4.1では、以下の変更が適用されました。

# LIFFアプリを閉じずに別のLIFFアプリを開く機能の不具合を修正しました

LIFF v2.4.0のリリースノートでお知らせした、LIFFアプリを閉じずに別のLIFFアプリを開く機能に不具合があり、条件を満たしていても正しく動作しないことがわかりました。

LIFF v2.4.1では、動作条件を下記に変更したうえで、不具合を修正しています。

項目 変更前 変更後
LIFF SDK 2.4.0 2.4.1
LINE 10.16.0 10.18.0
LIFF v2.4.0の利用は非推奨です

上記の不具合があるため、LIFF v2.4.0の利用は非推奨になります。 LIFF v2.4.0をお使いの場合は、v2.4.1へのアップデートをお勧めします。

詳しくは、『LIFFドキュメント』の「LIFFアプリから別のLIFFアプリを開いた場合の動作について」を参照してください。

# liff.isApiAvailable()でLIFF間遷移可能な状態か確認できるようになりました

APIの使用可否を確認するliff.isApiAvailable()で、LIFF間遷移可否の確認ができるようになりました。

別のLIFFアプリを開く前に、liff.isApiAvailable('multipleLiffTransition')を実行することで、LIFF間遷移が可能な状態か確認することができます。別のLIFFアプリを開く際に、エラーが発生することを避けることができます。

if (liff.isApiAvailable('multipleLiffTransition')) {
  window.location.href = "https://line.me/{liffId}", // URL for another LIFF app
}
liff.getContext()を使ってLIFF間遷移の情報を取得する

LIFFアプリの情報を取得するliff.getContext()を使って、LIFF間遷移の可否や、実行可能なLINEバージョンを取得することもできるようになりました。

  • availability.multipleLiffTransition.permission：別のLIFFアプリへの遷移が可能かどうかを表します。
  • availability.multipleLiffTransition.minVer：別のLIFFアプリへの遷移が可能なLINEの最小バージョンを表します。

以下は、liff.getContext()を実行した際の戻り値の例です。

{
  "type": "utou",
  "utouId": "UU29e6eb36812f484fd275d41b5af4e760926c516d8c9faa35…b1e8de8fbb6ecb263ee8724e48118565e3368d39778fe648d",
  "userId": "U70e153189a29f1188b045366285346bc",
  "viewType": "full",
  "accessTokenHash": "ArIXhlwQMAZyW7SDHm7L2g",
  "availability": {
    "shareTargetPicker": {
      "permission": true,
      "minVer": "10.3.0"
    },
    "multipleLiffTransition": {
      "permission": true,
      "minVer": "10.18.0"
    }
  }
}

詳しくは、『LIFF APIリファレンス』の「liff.isApiAvailable()」および「liff.getContext()」を参照してください。

# liff.init()が二回呼びだされた際の動作を修正しました

liff.init()によるLIFFアプリの初期化が成功する条件下においてliff.init()を2回以上実行すると、rejectされたPromiseオブジェクトがエラーメッセージと共に返却されていました。

LIFF v2.4.1では、liff.init()が成功する条件下においてliff.init()を2回以上実行すると、resolveされたPromiseオブジェクトが返却され、警告メッセージが出力されるよう修正されました。

LIFFアプリの初期化について詳しくは『LIFFドキュメント』の「LIFFアプリを初期化する」を参照してください。

2020/09/14

# LIFF v2.3.2をリリースしました

LIFF v2.3.2では、以下の変更が適用されました。

# LIFFエンドポイントURLに含まれるURLフラグメントがliff.permanentLink.createUrl()で正しく処理されない不具合を修正しました

LIFFのエンドポイントURLにURLフラグメント（#URL-fragment）が含まれていた場合、liff.permanentLink.createUrl()を実行した際、［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されているにも関わらずパーマネントリンクにURLフラグメントが含まれる不具合がありました。

問題が発生する条件
  • LIFFのLIFFのエンドポイントURLにURLフラグメントが含まれている
  • ［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されている

たとえば、［エンドポイントURL］がhttps://example.com/path#sectionに設定されていて、liff.permanentLink.createUrl()を実行するとhttps://liff.line.me/{liffId}/path?liff.state=#sectionがパーマネントリンクとして返されていました。LIFF v2.3.2では、https://liff.line.me/{liffId}が正しく返されるよう修正されています。

# LIFFエンドポイントURLに含まれるクエリパラメータがliff.permanentLink.createUrl()で正しく処理されない不具合を修正しました

LIFFのエンドポイントURLにクエリパラメータ（?key=value）が含まれていて、同じクエリパラメータが含まれるLIFF URLでliff.permanentLink.createUrl()を実行するとクエリパラメータ部分が無限増殖したパーマネントリンクが返される不具合がありました。

問題が発生する条件
  • LIFFのエンドポイントURLに含まれるクエリパラメータとliff.permanentLink.createUrl()を実行する際のLIFF URLのクエリパラメータが一致する
  • ［LIFF URLの追加情報の処理方法］が「連結」に設定されている

たとえば、［エンドポイントURL］がhttps://example.com/path1/?q1=v1&q2=v2に設定されていて、https://liff.line.me/{liffid}/?q1=v1&q2=v2でliff.permanentLink.createUrl()を実行すると、https://liff.line.me/{liffid}/?q1=v1&q1=v1&q2=v2&q2=v2のようにクエリパラメータ部分が無限増殖したパーマネントリンクが返されていました。

LIFF v2.3.2では、https://liff.line.me/{liffid}/?q1=v1&q2=v2が正しく返されるよう修正されています。

# LIFFエンドポイントURLに含まれるパスがliff.permanentLink.createUrl()で正しく処理されない不具合を修正しました

LIFFのエンドポイントURLにパスが含まれていて、パスの末尾にスラッシュ（/）が使用されていた場合、liff.permanentLink.createUrl()を実行して取得したパーマネントリンクをクリックすると以下のようにパスの末尾のスラッシュ（/）がリダイレクト先に含まれない不具合がありました。

問題が発生する条件
  • LIFFのエンドポイントURLにパス（/path/）が含まれていて、パスの末尾にスラッシュ（/）が使用されている
  • LIFFのエンドポイントURLにクエリパラメータ（?key=value）やURLフラグメント（#URL-fragment）が含まれている
  • ［LIFF URLの追加情報の処理方法］が「連結」に設定されている

たとえば、［エンドポイントURL］がhttps://example.com/path/?id=xxxxxxxに設定されていて、liff.permanentLink.createUrl()を実行して取得したパーマネントリンクにアクセスするとパスの末尾のスラッシュ（/）がリダイレクト先に含まれず、https://example.com/path?id=xxxxxxxに遷移されていました。

LIFF v2.3.2では、https://example.com/path/?id=xxxxxxxへ正しく遷移されるよう修正されています。

# 2次リダイレクト先URLにフラグメントが含まれない不具合を修正しました

LIFFのエンドポイントURLやLIFF URLにURLフラグメントが含まれていた場合、［LIFF URLの追加情報の処理方法］の設定に関わらず、2次リダイレクト先URLにフラグメントが含まれない不具合を修正しました。

2次リダイレクト先URLや［LIFF URLの追加情報の処理方法］の設定による2次リダイレクト先URLへの影響について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

# LIFF URLが意図しないURLへリダイレクトされる不具合を修正しました

LIFF URLに指定した追加情報（例：path/?key=value）は、1次リダイレクト先URLではliff.stateクエリパラメータに含まれます。liff.stateクエリパラメータに追加情報が含まれる場合に、以下のように意図しない2次リダイレクト先URLに遷移する不具合がありました。

問題が発生する条件
  • liff.stateクエリパラメータの先頭に/がない
  • ［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されている

たとえば、［エンドポイントURL］がhttps://example.comに設定されており、liff.stateクエリパラメータがpathだった場合、ドメイン名とパスが/で分離されず、https://example.compathにリダイレクトされていました。
LIFF v2.3.2では、https://example.com/pathに正しくリダイレクトされるよう修正されています。

意図しないリダイレクトによる脆弱性について

この不具合を利用することで、悪意あるサイトへ誘導される危険があります。v2.4.0より前のLIFF SDKをお使いの場合はアップデートをおすすめします。

LIFF URLへのアクセス時の動作について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2020/09/14

# LIFF v2.2.1をリリースしました

LIFF v2.2.1では、以下の変更が適用されました。

LIFF URLに指定した追加情報（例：path/?key=value）は、1次リダイレクト先URLではliff.stateクエリパラメータに含まれます。liff.stateクエリパラメータに追加情報が含まれる場合に、以下のように意図しない2次リダイレクト先URLに遷移する不具合がありました。

問題が発生する条件
  • liff.stateクエリパラメータの先頭に/がない
  • ［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されている

たとえば、［エンドポイントURL］がhttps://example.comに設定されており、liff.stateクエリパラメータがpathだった場合、ドメイン名とパスが/で分離されず、https://example.compathにリダイレクトされていました。
LIFF v2.2.1では、https://example.com/pathに正しくリダイレクトされるよう修正されています。

意図しないリダイレクトによる脆弱性について

この不具合を利用することで、悪意あるサイトへ誘導される危険があります。v2.4.0より前のLIFF SDKをお使いの場合はアップデートをおすすめします。

LIFF URLへのアクセス時の動作について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2020/09/14

# LIFF v2.1.14をリリースしました

LIFF v2.1.14では、以下の変更が適用されました。

LIFF URLに指定した追加情報（例：path/?key=value）は、1次リダイレクト先URLではliff.stateクエリパラメータに含まれます。liff.stateクエリパラメータに追加情報が含まれる場合に、以下のように意図しない2次リダイレクト先URLに遷移する不具合がありました。

問題が発生する条件
  • liff.stateクエリパラメータの先頭に/がない
  • ［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されている

たとえば、［エンドポイントURL］がhttps://example.comに設定されており、liff.stateクエリパラメータがpathだった場合、ドメイン名とパスが/で分離されず、https://example.compathにリダイレクトされていました。
LIFF v2.1.14では、https://example.com/pathに正しくリダイレクトされるよう修正されています。

意図しないリダイレクトによる脆弱性について

この不具合を利用することで、悪意あるサイトへ誘導される危険があります。v2.4.0より前のLIFF SDKをお使いの場合はアップデートをおすすめします。

LIFF URLへのアクセス時の動作について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2020/08/31

# LIFF v2.4.0をリリースしました

2020年9月24日追記

LIFF v2.4.0の利用は、LIFFアプリを閉じずに別のLIFFアプリを開く機能に、不具合が発見されたため非推奨になりました。
この機能を利用するための条件が以下に変わりました。

項目 変更前 変更後
LIFF SDK 2.4.0 2.4.1
LINE 10.16.0 10.18.0

すでにLIFF v2.4.0をお使いの場合は、LIFF v2.4.1へのアップデートをお勧めします。

LIFF v2.4.0では、以下の変更が適用されました。

# LIFFアプリの初期化前でもliff.closeWindow()メソッドが実行できるようになりました

liff.init()メソッドでLIFFアプリを初期化する前に、liff.closeWindow()メソッドを実行できるようになりました。

LIFFアプリ初期化前にliff.closeWindow()メソッドを実行できる条件

LIFF SDKバージョンが2.4.0以上、ユーザーのLINEバージョンが10.15.0以上の場合、LIFFアプリ初期化前にliff.closeWindow()を実行できます。

以下のように、ネットワークエラーや、ユーザーのLINEバージョンなどによってLIFFアプリの初期化に失敗した場合に、liff.closeWindow()メソッドでLIFFアプリを閉じることができます。

liff
  .init({
    liffId: "123456-abcedfg", // Use own liffId
  })
  .then(() => {
    // Start to use liff's api
  })
  .catch((err) => {
    // Error happens during initialization
    console.log(err.code, err.message);
    liff.closeWindow();
  });

詳しくは、『LIFF APIリファレンス』の「liff.closeWindow()」を参照してください。

# LIFFアプリを閉じずに別のLIFFアプリを開くことができるようになりました

画面サイズがFull表示のLIFFアプリ内で、別のLIFFアプリへのリンクをクリックすると、LIFFブラウザを開いたまま別のアプリを表示することができます。
ブラウザが閉じないため、LIFFブラウザの戻るボタンで遷移元のLIFFアプリに戻ることができます。

LIFFアプリを閉じずに別のLIFFアプリに遷移できる条件（2020年9月24日追記）

LIFF v2.4.0では不具合があり、正しく動作しないことがわかりました。この機能の動作条件は以下に変更されています。

  • LIFF SDKバージョンが2.4.1以上、ユーザーのLINEバージョンが10.18.0以上
  • 遷移元のLIFFアプリの画面サイズがFull表示に設定されている
  • 遷移先のLIFFアプリがliff.init()で正しく初期化されている

LIFF-apps-transition

詳しくは、『LIFFドキュメント』の「LIFFアプリから別のLIFFアプリを開いた場合の動作について」を参照してください。

# LIFF URLが意図しないURLへリダイレクトされる不具合を修正しました

LIFF URLに指定した追加情報（例：path/?key=value）は、1次リダイレクト先URLではliff.stateクエリパラメータに含まれます。liff.stateクエリパラメータに追加情報が含まれる場合に、以下のように意図しない2次リダイレクト先URLに遷移する不具合がありました。

問題が発生する条件
  • liff.stateクエリパラメータの先頭に/がない
  • ［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」に設定されている

たとえば、［エンドポイントURL］がhttps://example.comに設定されており、liff.stateクエリパラメータがpathだった場合、ドメイン名とパスが/で分離されず、https://example.compathにリダイレクトされていました。
LIFF v2.4.0では、https://example.com/pathに正しくリダイレクトされるよう修正されています。

LIFF URLへのアクセス時の動作について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

# liff.permanentLink.createUrl()の不具合を修正しました

LIFFのエンドポイントURLにクエリパラメータ（?key=value）やURLフラグメント（#URL-fragment）などが含まれていた場合、liff.permanentLink.createUrl()を実行した際、場合により追加情報部分がパーマネントリンクに正しく反映されない不具合を修正しました。

# 2次リダイレクト先URLにフラグメントが含まれない不具合を修正しました

LIFFのエンドポイントURLやLIFF URLにURLフラグメントが含まれていた場合、［LIFF URLの追加情報の処理方法］の設定に関わらず、2次リダイレクト先URLにフラグメントが含まれない不具合を修正しました。

2次リダイレクト先URLや［LIFF URLの追加情報の処理方法］の設定による2次リダイレクト先URLへの影響について詳しくは、LIFFドキュメントの「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

2020/07/16

# LIFF v2.3.1をリリースしました

LIFF v2.3.1では、以下の変更が適用されました。

機能の変更はありません。

# LIFF SDKのnpmパッケージのドキュメントの不具合を修正しました

試験的に公開していたLIFF SDKのnpmパッケージに関するnpm公式サイト上のドキュメント (opens new window)の不具合を修正しました。

# LIFF SDKのnpmパッケージの利用手順を移動しました

LIFF SDKのnpmパッケージのインストールおよびLIFFアプリへの組み込みの手順をnpm公式サイト (opens new window)からLINE Developersサイトに移動しました。詳しくは、「LIFFアプリを開発する」の「npmパッケージを利用する」を参照してください。

2020/07/15

# LIFFのヘッダーに機能を追加しました

2020年7月6日にお知らせしたとおり、LIFFのヘッダーに機能を追加しました。

LIFF header design to be improved

# LIFFアプリのアイコンが非表示になりました

LIFFアプリの左上に表示されていたアイコンが非表示になりました。

# シェアボタンが表示されるようになりました

画面サイズをFullに設定しているLIFFアプリでは、ヘッダーにシェアボタンが表示されるようになりました。ユーザーがシェアボタンをタップすると、以下のオプションが表示されます。

項目 説明
シェア 現在開いているページのURLを、LINEメッセージでシェアします。
更新 現在開いているページを再読み込みします。

なお、LINE DevelopersコンソールでLIFFアプリの［モジュールモード］をオンにすると、シェアボタンを非表示にできます。

動作環境

シェアボタンは、iOS版LINE、Android版LINEのバージョン10.12.0以降で表示できます。

2020/07/01

# LIFF SDKをnpmパッケージとして公開しました

これまで、LIFFアプリにLIFF SDKを組み込むには、CDNパスを指定する必要がありました。

2020年7月1日より、LIFF SDKのnpmパッケージを試験的に公開しました。今後は、npmおよびYarnを利用して、LIFF SDKをインストールできます。

LIFF SDKのnpmパッケージについて詳しくは、https://www.npmjs.com/package/@line/liff (opens new window)を参照してください。

また、npmパッケージとして利用できるLIFF SDKのバージョンはv2.3.0以降です。今後のLIFF SDKのバージョンアップの内容については、このページでお知らせします。

注意

npmパッケージは、試験的に公開しています。今後、予告なく変更、または削除される可能性があります。

2020/06/29

# LIFF v2.3.0をリリースしました

LIFF v2.3.0では、以下の機能が追加されました。

# LIFFのエンドポイントURLでパスおよびクエリパラメータを利用できるようになりました

LINE Developersコンソールの［エンドポイントURL］に入力したパス（/path）およびクエリパラメータ（?key=value）を、LIFFアプリで利用できるようになりました。

LIFFアプリの［LIFF URLの追加情報の処理方法］を「連結」に設定した場合、LIFFアプリにアクセスすると、パスやクエリパラメータを含む［エンドポイントURL］と、［LIFF URL］に指定した追加情報を組み合わせたURLにリダイレクトします。

詳しくは、『LIFFドキュメント』の「LIFF アプリを開く」を参照してください。

liff.permanentLink.createUrl()メソッドを実行したとき、現在のページのURLが［エンドポイントURL］に指定したURLで始まらない場合に、例外が発生します。

特に［LIFF URLの追加情報の処理方法］が「置換（後方互換性モード）」のときは、［エンドポイントURL］に指定したパスやクエリパラメータ（/2020campaign/?key=value）が、2次リダイレクト先に含まれないことがあります。その場合、liff.permanentLink.createUrl()メソッドが上記の条件を満たすため、パーマネントリンクを取得できません。

詳しくは、『LIFF v2 APIリファレンス』の「liff.permanentLink.createUrl()」を参照してください。

# liff.shareTargetPicker()の送信結果を取得できるようになりました

仕様変更前は、ターゲットピッカーを表示できたかどうかをLIFFアプリが確認できましたが、その後、メッセージを送信できたかどうかは確認できませんでした。

仕様変更後は、メッセージを送信できたかどうかを確認できるため、ユーザーの状況に合わせて、LIFFアプリの挙動を変更するように実装できます。

注意
  • この仕様変更により、liff.shareTargetPicker()の戻り値に変更があります。
  • ユーザーがLINE 10.3.0～LINE 10.10.0を使用している場合は、この仕様変更の影響を受けません。

詳しくは、『LIFF v2 APIリファレンス』の「liff.shareTargetPicker()」を参照してください。

# liff.sendMessages()で返されるエラーコードを追加しました

liff.sendMessages()に不正なパラメータを渡した場合、LiffErrorのエラーコードで400が返されていました。仕様変更後は、400の代わりにINVALID_ARGUMENTが返されます。

なお、エラーコードによって処理を分岐していない場合は、仕様変更の影響を受けません。

詳しくは、2020年6月29日のニュースを参照してください。

2020/06/15

# LIFF v2.2.0：LiffErrorのコードを追加しました

以下のメソッドでPromiseがrejectされたときに渡されるLiffErrorのコードがより詳細になり、問題の原因がわかりやすくなりました。

詳しくは、以下のメソッドの「エラーレスポンス」を参照してください。

2020/04/30

# LIFF v2.1.13：LIFF v2にliff.getLineVersion()およびliff.idが追加されました

LIFF v2に、liff.getLineVersion()メソッドおよびliff.idプロパティが追加されました。

liff.getLineVersion()を使用すると、ユーザーのLINEバージョンを取得できます。

ユーザーがLIFFブラウザでLIFFアプリを開くと、ユーザーのLINEバージョンが文字列で返されます。ユーザーが外部ブラウザでLIFFアプリを開くと、 nullが返されます。

liff.idは、 liff.init()に渡したLIFFアプリID（String型）を保持するプロパティです。

詳しくは、『LIFF v2 APIリファレンス』の「liff.getLineVersion()」および「liff.id」を参照してください。

2020/04/03

# LIFF v2にliff.isApiAvailable()が追加されました

LIFF v2に、liff.isApiAvailable()が追加されました。指定したAPIが、LIFFアプリを起動した環境で使用可能かどうかを確認できます。

注意

指定できるAPIは限られています。現時点では、liff.shareTargetPicker()が対象です。今後、liff.isApiAvailable()で指定できるAPIが増えたときには、改めてお知らせします。

# ターゲットピッカーの使用可否の確認

liff.isApiAvailable()を事前に実行することで、ターゲットピッカーが使用不可能な環境でliff.shareTargetPicker()を実行した際、ユーザーの画面にエラーメッセージが表示されることを避けられます。

if (liff.isApiAvailable("shareTargetPicker")) {
  liff
    .shareTargetPicker([
      {
        type: "text",
        text: "Hello, World!",
      },
    ])
    .then(alert("ShareTargetPicker was launched"))
    .catch(function (res) {
      alert("Failed to launch ShareTargetPicker");
    });
}

詳しくは、『LIFF v2 APIリファレンス』の「liff.isApiAvailable()」を参照してください。

2020/03/03

# LIFF v2にliff.shareTargetPicker()およびliff.readyが追加されました

LIFF v2に、liff.shareTargetPicker()およびliff.readyが追加されました。

# liff.shareTargetPicker()

ターゲットピッカー（グループまたは友だちを選択する画面）を表示し、ターゲットピッカーで選択した相手に、開発者が作成したメッセージを送信するメソッドが追加されました。このメッセージは、ユーザーが送信したかのように、グループまたは友だちに表示されます。

target picker

詳しくは、『LIFFドキュメント』の「ユーザーの友だちにメッセージを送信する」を参照してください。

ターゲットピッカーの動作環境について

ターゲットピッカーは、iOS版とAndroid版のLINE 10.3.0以降でサポートされます。

# liff.ready

LIFFアプリ起動後、liff.init()の実行が初めて終了したときにresolveするPromiseオブジェクトを利用できるようになりました。liff.readyを利用すると、liff.init()の終了を待って、任意の処理を実行できます。

詳しくは、『LIFF v2 APIリファレンス』の「liff.ready」を参照してください。

2020/02/07

# LIFF v1 廃止対象APIと廃止スケジュール変更のお知らせ

LINE Front-end Framework（LIFF） v1のサーバーAPIを2020年3月31日に廃止する告知をしましたが、影響範囲を考慮し提供を継続します。

LIFF v1全体の廃止時期については、決まり次第改めてお知らせしますが、早めの移行を推奨します。

機能 変更前のスケジュール 変更後のスケジュール
LIFF v1 クライアントAPI 廃止予定 廃止予定（変更ありません）
LIFF v1 サーバーAPI 2020年3月31日廃止 提供を継続
LIFF v1の廃止予定は変わりません

2019年10月16日に告知したとおり、LIFF v1は、廃止される予定です。最新バージョンのLIFFを使用してください。

2020/02/05

# Messaging APIのチャネルにはLIFFアプリを追加できなくなりました

2019年11月11日に告知したとおり、LIFF v2の機能拡張に伴いMessaging APIのチャネルにはLIFFアプリを追加できなくなりました。

すでにMessaging APIチャネルに追加したLIFFアプリに関する制限や、LINEログインチャネルへの移行方法に関しては上記のニュース記事をご参照ください。

2020/01/21

# 2020年3月31日にLIFF v1のサーバーAPIの提供を終了します

2020年3月31日に、LINE Front-end Framework（LIFF） v1のサーバーAPIの提供を終了します。提供終了日に、以下の機能を削除する予定です。

最新バージョンのLIFFを使用してください

2019年10月16日に告知したとおり、LIFF v1は、廃止される予定です。

# LIFF v2を利用してください

提供を終了するサーバーAPIの機能は、すべてLINE Developersコンソールで利用できます。LIFFアプリをチャネルに追加する操作について詳しくは、以下の項目を参照してください。

そのほかの機能も、同様の操作で利用できます。

LINEは今後もお客様への一層のサービス向上に取組んでまいります。何卒ご理解を賜りますよう、よろしくお願い申し上げます。

2020/01/14

# 提供を一時停止しているLIFF SDKのAPIを使用している場合はコードを修正してください

2019年11月29日に告知したとおり、iOS版のLINE 9.19.0以降では、以下のAPIは、技術的な問題があり提供を一時停止しています。

  • liff.scanCode()
  • liff.bluetooth.*

さらに本日から、iOS版のLINE 9.19.0以降を使用するエンドユーザーがLIFFアプリを利用した場合は、それぞれのAPIは以下のように動作します。

API 動作
liff.scanCode() APIがundefinedになる
liff.bluetooth.* liff.initPlugins(['bluetooth'])を呼び出したときに、Bluetoothプラグインの初期化に失敗し、FORBIDDENエラーが返される

liff.scanCode()を利用する場合は、上記のケースも考慮し、関数の存在を確認することをお勧めします。

修正前：

liff.scanCode().then(result => {
  // result = { value: "" }
});

修正後：

if (liff.scanCode) {
	liff.scanCode().then(result => {
	  // result = { value: "" }
	});
}

詳しくは、『LIFF v2 APIリファレンス』を参照してください。

LINEは今後もお客様への一層のサービス向上に取組んでまいります。何卒ご理解を賜りますよう、よろしくお願い申し上げます。

2019/11/29

# LIFFの一部機能の提供の一時停止について

以下の機能は、技術的な問題があり提供を一時停止することになりました。今後の対応が決まり次第、改めてお知らせします。

  • liff.scanCode()
  • liff.bluetooth.*

# 一時停止バージョン

LINE 一時停止バージョン
iOS版LINE 9.19.0以降は、上記の機能の提供を一時停止します
Android版LINE 対応方法を検討しています

ご利用のユーザー様にはご不便をおかけいたしますが、何卒ご理解いただきますようお願い申し上げます。

2019/11/11

# Messaging APIのチャネルにはLIFFアプリを追加できなくなります

LIFF v2では、LINEログインを中核とした機能拡張を予定しています。そのため、LINEログインチャネルにLIFFアプリを追加することを推奨します。それに伴い、現在サポートしているMessaging APIチャネルにLIFFアプリを追加できなくなる仕様変更が予定されています。

# 仕様変更時期

2020年2月上旬

# 影響

チャネル種別 影響
LINEログインチャネル 仕様変更の影響を受けません。
Messaging APIチャネル 仕様変更以降は、Messaging APIチャネルにはLIFFアプリを追加できません。仕様変更時点でMessaging APIチャネルに追加済みのLIFFアプリは、引き続き使用できます。
Messaging APIチャネルにLIFFアプリを追加しないでください

現時点では、Messaging APIチャネルにLIFFアプリを追加することもできますが、追加しないでください。Messaging APIチャネルに追加したLIFFアプリには、以下の制限があります。

  • ボットリンク機能は利用できません。
  • LIFFの機能拡張に対応できない可能性があります。
  • LIFFアプリが使用できなくなる可能性があります。

なお、LINEログインチャネルに追加したLIFFアプリには制限がなく、LIFF v2のすべての機能を利用できます。

# LINEログインチャネルへの移行

Messaging APIチャネルに追加したLIFFアプリを継続して使用するには、LINEログインチャネルにLIFFアプリを追加し直してください。

LIFFアプリを追加し直すと、LIFFアプリIDが再発行されるため、以下の点に注意してください。

  • LIFF v2を利用している場合は、liff.init()に指定するLIFFアプリIDを変更してください。
  • LIFFを起動するためのLIFF URL（例：line://app/1234567890-AbcdEfgh）が変更されます。
Messaging APIチャネルに追加したLIFFアプリは削除してください

混乱を避けるために、LIFFアプリをLINEログインチャネルへ追加したあとで、Messaging APIチャネルに追加したLIFFアプリを削除してください。

2019/10/16

# LIFF v2がリリースされました

LINE Front-end Framework（LIFF） v2は、LINEが提供するウェブアプリのプラットフォームです。

最新バージョンのLIFFを使用してください

LIFF v1は、廃止される予定です。

# 外部ブラウザでLIFFアプリが動作します

LIFF v1では、LIFFアプリはLIFFブラウザでのみ動作していました。LIFF v2からは、外部ブラウザでも動作します。これにより、一般のウェブアプリと同じ開発環境で、LIFFアプリを開発できるようになりました。

# ユーザーのプロフィール情報とメールアドレスを取得できます

LINEログイン v2.1との互換性が向上したため、ユーザーIDやメールアドレスをLINEプラットフォームから取得できます。LIFFアプリではこれらを利用して、ユーザー情報を活用した機能を提供したり、メールを送信したりできます。

なお、外部ブラウザで動作しているときでも、LINEログインの処理（ウェブログイン）が利用できます。したがって、外部ブラウザで動作しているときも同様の情報を利用できます。

# QRコードを読み取れます

LINEのQRコードリーダーを起動し、ユーザーが読み取った文字列を取得できます。

# LIFFアプリの動作環境を細かく取得できます

LIFFアプリを動作させている環境の情報を細かく取得できます。取得できる情報は以下のとおりです。

  • LIFFアプリが動作しているOS（iOS、Android、外部ブラウザ）
  • LIFFブラウザで起動しているかどうか（true、false）
  • 言語設定

詳しくは、「LINE Front-end Framework」を参照してください。

2019/04/23

# LINE Front-end Frameworkの同意画面が改善されました

LINE Front-end Framework（LIFF）で、ユーザーがLIFFアプリを起動したときに表示される同意画面が改善されました。この改善は、すべてのLIFFアプリに自動的に適用されるため、追加の開発作業は不要です。

新画面（イメージ）

New consent screen

なお、ユーザーに「トークへのメッセージ送信」の認可を求めるLIFFアプリでは、同意画面でユーザーが許可しない場合があります。この場合は、次にユーザーがLIFFアプリを起動したときに同意画面が再表示されます。

2019/02/07

# LIFF SDKでアクセストークンを取得できるようになりました

LIFF SDKにliff.getAccessToken()メソッドが追加されました。

アクセストークンを使ってSocial APIにリクエストを送信し、LINEプラットフォームのユーザーデータにアクセスできます。

詳しくは、「ユーザーのアクセストークンを取得する」を参照してください。

2018/11/16

# LIFFのサーバーAPIが新しくなりました

LIFFアプリに以下のプロパティを設定できるようになりました。

  • descriptionプロパティ
  • features.bleプロパティ

また、LIFFアプリを更新するAPIが変更され、プロパティを部分的に変更できるようになりました。

詳しくは、以下のセクションを参照してください。

2018/10/30

# LIFFアプリをLINE Developersコンソールで追加できるようになりました

LIFFアプリをLINE Developersコンソールで追加できるようになりました。今までと同様に、LIFFサーバーAPIでもLIFFアプリを追加できます。

詳しくは、「LIFFアプリを追加する」を参照してください。

2018/07/19

# LIFFアプリ数の上限が変更されました

LINE Front-end Frameworkで、1つのチャネルあたり最大30件のLIFFアプリを追加できるようになりました。以前の最大登録数は10件でした。

詳しくは、『LIFF APIリファレンス』の「LIFFアプリを追加する」を参照してください。

2018/06/06

# LINE Front-end Frameworkがリリースされました

LINE Front-end Framework（LIFF）は、LINE内で動作するウェブアプリのプラットフォームです。

LIFFに登録したウェブアプリ（LIFFアプリ）をLINE内で起動すると、LINEのユーザーIDなどをLINEプラットフォームから取得できます。LIFFアプリではこれらを利用して、ユーザー情報を活用した機能を提供したり、ユーザーの代わりにメッセージを送信したりできます。

詳しくは、「LINE Front-end Framework」を参照してください。