Charts - iOS / tvOS / OSX用の美しいチャート!クロスプラットフォームMPAndroidChartのApple側。

(Beautiful charts for iOS/tvOS/OSX! The Apple side of the crossplatform MPAndroidChart.)

Created at: 2015-03-20 18:49:12
Language: Swift
License: Apache-2.0

バージョン4.0.0MPAndroidChart#f6a398bに同期

altタグ サポートされているプラ​​ットフォーム リリース 最新のポッドリリース カルタゴ互換 ビルドステータス codecov https://gitter.im/danielgindi/Chartsでチャットに参加してください

注意点:Charts3.0にはいくつかの重大な変更があります。リリース/移行に関する注意事項をお読みください。

もう1つの注意点:ChartsRealmは現在のリポジトリにあります。ポッドも今
Charts
ChartsRealm
はなく、
Charts/Core
Charts/Realm

もう1つ注意が必要です。Swiftが進化するにつれて、最新のSwiftコンパイラーを使用していない場合は、マスターブランチをチェックアウトしないでください。代わりに、リリースページに移動して、自分に合ったものを選択する必要があります。

  • Xcode 11 / Swift 5(マスターブランチ)
  • iOS> = 8.0(組み込みフレームワークとして使用)
  • tvOS> = 9.0
  • macOS> = 10.11

さて、Android開発者の間で非常に人気のあるPhilipp JahodaによるMPAndroidChartと呼ばれるこの美しいライブラリがありますが、iOS用のチャートを作成するための適切なソリューションはありませんでした。

Swift
コンパイラーによって高度に最適化でき、プロジェクト
Swift
とプロジェクトの両方で使用できるため、書き込みを選択しました
ObjC
。デモプロジェクトは、
ObjC
それがどのように機能するかを示すために書かれています。

Android、iOS、tvOS、macOSのこのライブラリの驚くべき機能は、学習曲線がシングルトンであるため、両方のプラットフォームで開発するときに時間を節約できることです。これは1回だけ発生し、コードは非常に類似しているため、開発者は別のライブラリで同じ出力を生成するために、アプリを回って再発明する必要はありません。(そしてそれは、現在そこに本当に別の良い選択がないという事実を考慮していません...)

デモの実行に問題がありますか?

  • ChartsDemo/ChartsDemo.xcodeproj
    iOS/tvOSのデモプロジェクトです
  • ChartsDemo-OSX/ChartsDemo-OSX.xcodeproj
    macOSのデモプロジェクトです
  • サポートされているバージョンのXcodeを実行していることを確認してください。
    • 通常、ここでは数行上で指定されています。
    • ほとんどの場合、最新のXcodeバージョンになります。
  • プロジェクトがSwift5.0をサポートしていることを確認してください
  • オプション:
    carthage checkout
    プロジェクトフォルダーで実行して、依存関係をフェッチします(つまり、依存関係をテストします)。
    • カルタゴをお持ちでない場合は、こちらで入手できます

使用法

正しくコンパイルするには:

  1. Charts.xcodeproj
    をプロジェクトにドラッグします
  2. ターゲットの設定に移動し、[埋め込みバイナリ]セクションの下の[+]を押して、Charts.frameworkを選択します。
  3. @import Charts
  4. ObjCプロジェクトでSwiftを使用する場合:
  • ブリッジヘッダーをインポートする必要があります。通常は「 YourProject- Swift.h 」なので、ChartsDemoでは「ChartsDemo-Swift.h」になります。プロジェクトに「 ChartsDemo-Swift.h 」を実際に含めようとしないでください:-)
  • (Xcode 8.1以前)[ビルドオプション]で、[埋め込みコンテンツにSwiftコードが含まれている]をマークします
  • (Xcode 8.2+)[ビルドオプション]で、[常にSwift標準ライブラリを埋め込む]をマークします
  1. Realm.ioを使用する場合:
    • RealmフレームワークはChartsとリンクされていないことに注意してください。これは、オプションのバインディングのためにのみ存在します。つまり、プロジェクトにフレームワークがあり、Chartsでコンパイルされたものと互換性のあるバージョンである必要があります。常に最新バージョンに対してコンパイルするように最善を尽くします。
    • ChartsRealm
      依存関係としても追加する必要があります。

サードパーティのチュートリアル

ビデオチュートリアル

ブログ投稿

チュートリアルをここに表示したいですか?PRを作ろう!

トラブルシューティング

コンパイルできませんか?

  • CocoaPodsまたはCarthageからコンパイルされたフレームワークをインストールすることと、ソースコードをコピーすることの違いに注意してください。
  • 使用法のセクションをもう一度お読みください。
  • 問題を検索する
  • 問題のセクションで丁寧に質問してみてください

その他の問題/機能のリクエスト

  • 問題を検索する
  • 問題のセクションで丁寧に質問してみてください

CocoaPodsインストール

pod 'Charts'
Podfileに追加します。「チャート」はライブラリの名前です。レルム
のサポート については、追加してください。
pod 'ChartsRealm'

ノート:

pod 'ios-charts'
は正しいライブラリではなく、他の誰かによる別のプロジェクトを参照しています。

カーセージインストール

チャートには、Carthageのビルド済みバイナリが含まれるようになりました。

github "danielgindi/Charts" == 4.0.0
github "danielgindi/Charts" ~> 4.0.0

新しいリリースのバイナリをビルドするには、を使用します

carthage build --no-skip-current && carthage archive Charts

SwiftPackageManagerのインストール

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

dependencies: [
    .package(url: "https://github.com/danielgindi/Charts.git", .upToNextMajor(from: "4.0.0"))
]

サードパーティのバインディング

Xamarin(@ Flash3001による):iOS - GitHub / NuGetAndroid - GitHub / NuGet

ヘルプ

ここに表示されているものが好きで、このリポジトリで行われている作業をサポートしたい場合は、次のことができます。

  • コード、問題、プルリクエストを投稿する
  • このライブラリが存在することを人々に知らせてください(🔥言葉を広める🔥)。
  • 寄付(あなたは私にビールを買うことができます、またはあなたは私に夕食を買うことができます:-)

注:MPAndroidChartの作成者は、このライブラリが存在する理由であり、彼のページで寄付を受け付けています。彼はそれらに値する!

質問と問題

質問や問題がある場合は、次のことを行う必要があります。

  • ライブラリの最新バージョンを使用していることを確認してください。リリースセクションを確認してください。
  • Android版のドキュメントを調べる-Wiki
  • タグを使用してstackoverflowで質問を検索または開く
    ios-charts
  • 問題の既知の問題を検索します(オープンおよびクローズ)
  • 新しい問題を作成してください(🔥 以前に既知の問題を検索する 🔥、重複する問題を作成しないでください)

特徴

コア機能:

  • 8種類のチャートタイプ
  • 両方の軸でのスケーリング(タッチジェスチャ、軸を個別に、またはピンチズームを使用)
  • ドラッグ/パン(タッチジェスチャあり)
  • 結合チャート(線-、棒-、散乱-、ろうそく足-、泡-)
  • デュアル(個別)軸
  • カスタマイズ可能な軸(x軸とy軸の両方)
  • 値の強調表示(カスタマイズ可能なポップアップビューを使用)
  • チャートをカメラロールに保存/PNG/JPEGにエクスポート
  • 事前定義されたカラーテンプレート
  • 凡例(自動的に生成され、カスタマイズ可能)
  • アニメーション(x軸とy軸の両方でアニメーションを作成します)
  • 制限線(追加情報、最大値などを提供)
  • 完全にカスタマイズ可能(ペイント、書体、凡例、色、背景、ジェスチャー、破線など)
  • Realm.ioモバイルデータベースから直接データをプロットする(ここ

チャートタイプ:

スクリーンショットは、まったく同じようにレンダリングされるため、現在、元のリポジトリから取得されています:-)

  • 折れ線グラフ(凡例付き、シンプルなデザイン) altタグ

  • 折れ線グラフ(凡例付き、シンプルなデザイン) altタグ

  • 折れ線グラフ(立方線) altタグ

  • 折れ線グラフ(グラデーション塗りつぶし) altタグ

  • 結合チャート(この場合は棒グラフと折れ線グラフ) altタグ

  • 棒グラフ(凡例付き、シンプルなデザイン)

altタグ

  • 棒グラフ(グループ化されたデータセット)

altタグ

  • 水平-棒グラフ

altタグ

  • 円グラフ(選択あり、...)

altタグ

  • ScatterChart(正方形、三角形、円などを含む)

altタグ

  • CandleStickChart(財務データ用)

altタグ

  • BubbleChart(バブルで覆われた領域は値を示します)

altタグ

  • レーダーチャート(クモの巣チャート)

altタグ

ドキュメンテーション

APIはAndroidと95%同じであるため、現在iOS / tvOS/macOSバージョンのドキュメントは必要ありません。
ここで公式のMPAndroidChartドキュメントを読むことができます:Wiki

または、Objective-CとSwiftの両方でCharts Demoプロジェクト(ChartsDemo-iOS、およびmacOS ChartsDemo-macOS)を表示し、そこからハウツーを学ぶことができます。

特別な感謝

新しい機能、バグ修正、およびオープンソースコミュニティへの多くの関与については、@ liuxuan30、@ petester42、および @AlBirdieにアクセスしてください。皆さんは質問や問題を抱えてここに来るすべての人にとって大きな助けになります、そして私はあなたなしではそれらすべてに答えることができませんでした。

私たちの素晴らしいスポンサー

Debricked:オープンソースを安全に使用する

デブリック

ライセンス

Copyright 2016 Daniel Cohen Gindi&Philipp Jahoda

Apacheライセンスバージョン2.0(「ライセンス」)に基づいてライセンス供与されます。 ライセンスに準拠する場合を除き、このファイルを使用することはできません。 ライセンスのコピーは、次のURLで入手できます。

http://www.apache.org/licenses/LICENSE-2.0

適用法で義務付けられているか、書面で合意されていない限り、ソフトウェア ライセンスに基づいて配布されるものは、「現状有姿」で配布されます。 明示または黙示を問わず、いかなる種類の保証または条件もありません。 許可を管理する特定の言語については、ライセンスを参照してください。 ライセンスに基づく制限。