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用ロッティ

バージョン カルタゴ対応 SwiftPM ライセンス プラットホーム Swift バージョン

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

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

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

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

Lottie のパワーのごく一部をご紹介します。

例1 例2

例3

腹筋

ロッティのインストール

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

Github リポジトリ

Lottie Github Repoをプルして

Lottie.xcodeproj
、動的または静的ライブラリを構築するために含めることができます。

Swift パッケージ マネージャー

Swift Package Managerを使用して Lottie をインストールするには、現在のバージョンの Lottie リポジトリの URL を使用して、Apple が公開したチュートリアル に従うことができます。

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

ココアポッド

Podfile に Pod を追加します。

pod 'lottie-ios'

そして実行します:

pod install

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

import Lottie

カルタゴ

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 Style Guideに従ってフォーマットする必要があります。変更を行った後、 を実行して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