cyborgのダウンロード - cyborgソースコードのダウンロード

cyborg

その他のソースコード

vOS, and SwiftUI Support

ダウンロード

サイボーグ

Cyborgは、AndroidのiOSに可能なVectordRawawableの部分的なポートです。これは、UIIMAGE、アイコンフォント、AppleのPDFベクトル画像オプションの代替品として意図されています。 VectordRawableフォーマットは、多くの利点を提供します。

イラストの個々の要素の完全なテーマサポート、単純な画像の色合いを超えて、アイコンフォントのテキスト色を変更する
両方のプラットフォームに1つの資産を使用する機能、設計の簡素化 - >エンジニアリングパイプライン
資産は解像度独立しています
RTLサポート
Android Studioまたはサードパーティのツールを使用してSVGから簡単に変換できます

Cyborgは、MacOS（AppKit）、TVOSもサポートしており、Swiftuiから使用できます。ただし、これらの実装は現在、iOSバージョンよりも成熟度が低いことに注意してください。

パフォーマンスの比較

ドライバーアプリのアイコンセットに含まれる50以上のアイコンをロードして、サイボーグに多くの代替品に対してベンチマークしました。

サイボーグのパーサーは、見つけることができるiOSSVGライブラリよりも速いです
それはUIImageよりも少し遅い傾向があります。違いは、実際にはミリ秒の分数にあるはずです
約50個のアイコンを備えたアイコンフォントは、同様の複雑さの約2〜3個のドローブルをロードするのにかかる時間にロードできます。

解析パフォーマンスが問題になる場合、アプリケーションに適したキャッシュメカニズムを実装するか、サイボーグのスレッドの安全性を活用してメインスレッドからの解析を実行することをお勧めします。

とはいえ、現在、多くのパフォーマンス改善の機会が存在するため、将来的にはパフォーマンスが向上するはずです。この執筆時点では、Swiftは若い言語であり、特に文字列の作成、閉鎖、所有権において、パフォーマンスの改善もCyborgのパフォーマンスにプラスの影響を与えるはずです。

機能の完全なリストは、Androidドキュメントに列挙されています。

サイボーグのインストール

Cyborgは、Swift Package ManagerとCarthageをサポートしています。

Carthageを使用してインストールするには：

カルタゴを手に入れましょう。
cartfileに次のものを追加します： github "uber/cyborg" ~> [desired version]

Swift Package Managerを使用してXcodeプロジェクトにCyborgを追加するには、Appleが提供する指示に従ってください。

サイボーグの使用

以下の統合手順に従った後、Cyborgを使用するには、 UIImage使用するよりもわずかに多くのコードだけが必要です。

 let vectorView = VectorView ( theme : myTheme )
vectorView . drawable = VectorDrawable . named ( " MyDrawable " )

統合

Cyborgは、複雑な使用ケースまでスケールアップするように作られているため、上記のクリーンコードサンプルを取得するには、少し構成が必要です。

開始するための最小限の統合を書く方法を見てみましょう：

テーマとリソースの実装

VectordRawablesの最良の特徴の1つは、実行時に任意の値で交換できることです。よく著者のVectordRawableアセットは、ナイトモードなどのアプリ状態の変化に応じて色を変更できます。

ただし、これらの強力な機能にアクセスするには、独自のテーマとリソースプロバイダーを書く必要があります。

 class Theme : Cyborg . ThemeProviding {

    func colorFromTheme ( named _ : String ) -> UIColor {
        return . black
    }

}

class Resources : ResourceProviding {

    func colorFromResources ( named _ : String ) -> UIColor {
        return . black
    }

}

リソースが変わらないと仮定すると、最初のコードサンプルに描かれた利便性の初期イザーを書くことができます。

 fileprivate let resources = Resources ( )

extension VectorDrawable {
    public convenience init ( theme : Theme ) {
        self . init ( theme : theme , resources : resources ( )
    }
}

描画可能な解析エラーの報告：

何らかの理由で、Cyborgに無効なVectordrawawを提供する場合、Cyborgの標準作成関数は、選択したクラッシュレポートサービスの非致命的であると報告し、ローカルでデバッグするために使用できる詳細なエラーメッセージを提供します。これは、アプリの「プラットフォーム」レベルで処理でき、解析が常に成功すると仮定するコードを作成できます。

 extension VectorDrawable {
    public static func named ( _ name : String ) -> VectorDrawable ? {
        return Bundle . main . url ( forResource : name , withExtension : " xml " ) . flatMap { url in
        switch VectorDrawable . create ( from : url ) {
            case . ok ( let drawable ) :
                return drawable
            case . error ( let error ) :
               myAssertionFailureThatAlsoReportsToBackend ( " Could not create a vectordrawable named ( name ) ; the error was ( error ) " )
               return nil
        }
    }
}