cyborg

Cyborg

Cyborg ist ein teilweise Hafen von Androids Vektorderschaft für iOS. Es ist als Ersatz für UIImages, Icon -Schriftarten und die PDF -Vektor -Bildoption von Apple gedacht. Das vektordrawable Format bietet eine Reihe von Vorteilen:

• Vollständige Themenunterstützung einzelner Elemente einer Illustration, über das einfache Bildtönung oder das Ändern der Textfarbe in einer Symbolschrift
• Möglichkeit, ein Asset für beide Plattformen zu verwenden und das Design zu vereinfachen -> Engineering Pipeline
• Vermögenswerte sind unabhängige Lösung
• RTL -Unterstützung
• Einfach mithilfe von SVG mit Android Studio- oder Drittanbieter-Tools konvertierbar

Cyborg unterstützt auch MacOS (Appkit), TVOS und kann von Swiftui verwendet werden. Beachten Sie jedoch, dass diese Implementierungen derzeit weniger reif sind als die iOS -Version.

Leistungsvergleiche

Wir haben Cyborg an eine Reihe von Alternativen untersucht und die über 50 -jährigen Symbole geladen, die im Symbol unserer Fahrer -App enthalten sind.

• Cyborgs Parser ist schneller als die iOS -SVG -Bibliotheken, die wir finden konnten
• Es ist tendenziell etwas langsamer als UIImage . Die Unterschiede sollten in den Fraktionen von Millisekunden in der Praxis liegen
• Eine Symbolschrift mit ~ 50-Symbolen kann in der Zeit geladen werden, die zum Laden von 2-3 Drawables mit ähnlicher Komplexität erforderlich ist.

Wenn die Parsenleistung zu einem Problem wird, möchten Sie möglicherweise entweder einen Caching -Mechanismus implementieren, der für Ihre Anwendung geeignet ist, oder die Sicherheit von Cyborg nutzen, um das Parsen des Hauptfadens durchzuführen.

Trotzdem gibt es derzeit viele Möglichkeiten zur Leistungsverbesserung, sodass sich die Leistung in Zukunft verbessern sollte. Zum jetzigen Zeitpunkt ist Swift eine junge Sprache, und die Leistungsverbesserungen, insbesondere bei der Erstellung von String, Schließungen und Besitzer sollten sich auch positiv auf die Leistung von Cyborg auswirken.

Die vollständige Liste der Funktionen wird in der Android -Dokumentation aufgezählt.

Installation von Cyborg

Cyborg unterstützt Swift Package Manager und Karthago.

Mit Karthago zu installieren:

1. Holen Sie sich Karthago.
2. Fügen Sie Ihrem Cartfile Folgendes hinzu: github "uber/cyborg" ~> [desired version]

Um Cyborg zu einem Xcode -Projekt mit Swift Paket Manager hinzuzufügen, befolgen Sie die von Apple bereitgestellten Anweisungen.

Mit Cyborg

Nach der folgenden Integrationsschritten erfordert die Verwendung von Cyborg nur geringfügig mehr Code als die Verwendung eines UIImage :

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

Integration

Cyborg wird hergestellt, um auf komplexe Verwendungsfälle zu skalieren, und erfordern daher ein bisschen Konfiguration, um die oben genannte Clean -Code -Probe zu erhalten.

Lassen Sie uns sehen, wie Sie die minimale Integration schreiben, um loszulegen:

Implementierung von Themen und Ressourcen

Eine der besten Funktionen von VectorDrawables ist die Fähigkeit, zur Laufzeit willkürliche Werte auszutauschen. Gut verfasste Vectordrawable -Assets können ihre Farben als Reaktion auf Änderungen im App -Status wie einen Nachtmodus ändern.

Wenn wir jedoch Zugriff auf diese leistungsstarken Funktionen erhalten, müssen wir unser eigenes Thema und unsere Ressourcenanbieter schreiben:

 class Theme : Cyborg . ThemeProviding {

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

}

class Resources : ResourceProviding {

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

}

Unter der Annahme, dass sich Ressourcen nie ändern, können wir jetzt den im ersten Code -Beispiel dargestellten Convenience -Initialisierer schreiben:

 fileprivate let resources = Resources ( )

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

Berichterstattung über zeichnbare Parsefehler:

Wenn Sie aus irgendeinem Grund Cyborg eine ungültige Vektorderschaft anbieten, gibt Ihnen die Standard -Erstellungsfunktion in Cyborg eine detaillierte Fehlermeldung, die Sie als nicht tödlich für den Crash -Berichtsdienst Ihrer Wahl melden und lokal debuggen können. Dies kann auf der "Plattform" Ihrer App gehandhabt werden, sodass Sie Code schreiben können, der davon ausgeht, dass das Parsen immer erfolgreich ist, genau wie bei UIImage:

 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
        }
    }
}

Best Practices

Lint -Vektordrawable -Vermögenswerte

Wie Sie vielleicht bereits bemerkt haben, werden das Thema und die Ressourcenobjekte, die Sie in einem früheren Abschnitt geschrieben haben, tippt. Um Probleme mit Vermögenswerten zu verhindern, die auf nicht vorhandene Themen oder Ressourcenfarben verweisen, möchten Sie möglicherweise die XML -Dateien enthält, um sicherzustellen, dass sie gültig sind.

Speichern Sie Ihre Vektorordables in einem einzigen Repo

Möglicherweise finden Sie es bequem, Desigern es zu ermöglichen, neue Vermögenswerte direkt an ein Repo zu verpflichten, das von Designer in Ihre Android- und iOS -Repos eingezogen werden kann.

Snapshot testen Sie Ihre VectorDrawable

Der einfachste Weg, um die Korrektheit Ihrer Benutzeroberfläche zu gewährleisten, die statische Vektor -Zeichnungen verwenden, besteht darin, die Benutzeroberfläche zu prüfen, die sie verwenden, die ein Werkzeug wie Iossnapshottestcase verwenden. Dadurch wird sichergestellt, dass jeder Code, der nicht mit Compiler-verifiziert ist, Ihren Erwartungen entspricht.