lottie-ios - After Effects ベクターアニメーションをネイティブにレンダリングするための iOS ライブラリ

(An iOS library to natively render After Effects vector animations)

Created at: 2016-10-07 06:38:38
Language: Swift
License: Apache-2.0

iOS用ロッティ

バージョン カルタゴ互換 スウィフトPM ライセンス プラットホーム スウィフトバージョン

ドキュメント、FAQ、ヘルプ、例などを airbnb.io/lottie で表示

Lottie は、iOS、macOS、tvOS、Androidおよび Web 用のクロスプラットフォーム ライブラリで、ベクター ベースのアニメーションとアートを最小限のコードでリアルタイムでネイティブにレンダリングします。

Lottie は、bodymovin JSON 形式でエクスポートされたアニメーションとベクターを読み込み、レンダリングします。Bodymovin JSON は、bodymovin を使用した After Effects 、Lottie Sketch Export を使用したスケッチ、および Haiku から作成およびエクスポートできます。

デザイナーは、エンジニアが手作業で苦労して再現することなく、美しいアニメーションを作成して出荷できます。アニメーションはJSONによってサポートされているため、サイズは非常に小さいですが、複雑さが大きくなる可能性があります。アニメーションは、再生、サイズ変更、ループ、スピードアップ、スローダウン、反転、さらにはインタラクティブにスクラブすることもできます。Lottieはアニメーションの一部だけを再生またはループすることもできますが、可能性は無限大です!アニメーションは実行時にさまざまな方法で変更することもできます!色、位置、または任意のキーフレーマブル値を変更します!

ここにロッティの力のほんの一例があります

実施例1 実施例2

実施例3

いろは

ロッティのインストール

Lottie は Swift Package ManagerCocoaPodsCarthage (動的および静的の両方) をサポートしています。

Github Repo

Lottie Githubリポジトリをプルし、動的または静的なライブラリを構築するために含めることができます。

Lottie.xcodeproj

スウィフトパッケージマネージャ

Swiftパッケージマネージャを使用してLottieをインストールするには、現在のバージョンのLottieリポジトリのURLを使用してAppleが公開したチュートリアルに従ってください。

  1. Xcodeで、「ファイル」→「Swiftパッケージ」→「パッケージ依存関係の追加」を選択します。
  2. https://github.com/airbnb/lottie-ios.git を入力

ココアポッド

ポッドをポッドファイルに追加します。

pod 'lottie-ios'

そして、次のコマンドを実行します。

pod install

あなたのプロジェクトにココアポッドをインストールした後、Lottieをインポートします

import Lottie

カルタゴ

あなたのカートファイルにロッティを追加します。

github "airbnb/lottie-ios" "master"

そして、次のコマンドを実行します。

carthage update

「リンクされたフレームワークとライブラリ」セクションの下にあるアプリケーションターゲットの「一般」タブで、生成されたCarthage/Build/iOSディレクトリからlottie-ios.frameworkをドラッグアンドドロップします。

carthage update

データ収集

Lottie SDK はデータを収集しません。この通知は、アプリのプライバシーの詳細を記入する際に役立ちます。

貢献

私たちは常にコミュニティからの貢献に感謝します。プロジェクトに変更を加えるには、リポジトリを複製して を開きます。このワークスペースには、次のものが含まれます。

Lottie.xcworkspace

  • Lottie フレームワーク (iOS、macOS、tvOS 用)
  • 単体テストとスナップショットテスト(iOSの場合、iPhone 8シミュレータで実行する必要があります)
  • リポジトリに含まれる100以上のサンプルアニメーションを参照してテストできるiOSアプリの例

アニメーションのレンダリング方法に影響する新機能やバグ修正を含むすべてのプル要求には、含まれている変更を検証するスナップショット テスト ケースを含める必要があります。

  • スナップショット テスト スイートに新しいサンプル アニメーションを追加するには、 にファイルを追加します。スナップショット テストを再実行して、新しいスナップショット イメージ ファイルを生成します。
    .json
    Tests/Samples
  • 変更後に既存のスナップショットを更新するには、スナップショット テストを設定してから再実行します。
    isRecording = true
    SnapshotTests.swift

このプロジェクトには、Rakefileで定義されているいくつかの便利なコマンドも含まれています。これらを使用するには、Bundlerをインストールする必要があります。

$ sudo gem install bundle
$ bundle install

たとえば、すべてのSwiftコードはAirbnbのSwiftスタイルガイドに従ってフォーマットする必要があります。変更を加えた後、 を実行することで、SwiftFormatSwiftLint を使用してコードを自動的に再フォーマットできます。その他の便利なコマンドは次のとおりです。

bundle exec rake format:swift

$ bundle exec rake build:all # builds all targets for all platforms
$ bundle exec rake build:package:iOS # builds the Lottie package for iOS
$ bundle exec rake test:package # tests the Lottie package
$ bundle exec rake format:swift # reformat Swift code based on the Airbnb Swift Style Guide