Charts para Swift: guia completo com exemplos

Introdução ao Charts para Swift

Charts é uma biblioteca poderosa e flexível de código aberto para visualização de dados nas plataformas Apple (iOS, tvOS, macOS, watchOS). Ela é escrita em Swift e oferece uma ampla gama de tipos de gráficos: desde linhas e barras simples até gráficos combinados e de bolhas complexos. A biblioteca é um fork da famosa biblioteca iOS ios-charts, que, por sua vez, foi portada da biblioteca Java MPAndroidChart.

Por que usar Charts?

\n
• Visualização de dados: Transforma números chatos em gráficos e diagramas visuais.
\n
• Funcionalidade rica: Suporta animação, interação (toques, destaque), legendas, eixos, marcadores de dados e muito mais.
\n
• Desempenho nativo: Escrita em Swift, utiliza Core Graphics e Core Animation, garantindo operação suave mesmo com grandes conjuntos de dados.
\n
• Facilidade de integração: Instala-se facilmente via Swift Package Manager, CocoaPods ou Carthage.
\n
• Comunidade ativa: Atualizada regularmente, possui documentação extensa e muitos exemplos.
\n

Instalação da biblioteca Charts

Charts pode ser instalada por um dos três métodos principais. O recomendado é o Swift Package Manager (SPM).

1. Swift Package Manager (SPM) — Método recomendado

\n
1. No Xcode, abra seu projeto.
\n
2. Selecione File → Add Packages...
\n
3. No campo de busca, insira a URL do repositório: https://github.com/danielgindi/Charts.git
\n
4. Selecione a versão desejada (geralmente a última estável).
\n
5. Clique em Add Package.
\n
6. Certifique-se de que o pacote foi adicionado ao seu target.
\n

2. CocoaPods

Adicione ao seu Podfile:

platform :ios, '13.0'\nuse_frameworks!\n\ntarget 'YourApp' do\n  pod 'Charts'\nend

Em seguida, execute o comando no terminal:

pod install

3. Carthage

Adicione ao seu Cartfile:

github "danielgindi/Charts"

Em seguida, execute:

carthage update

Início rápido: Criando seu primeiro gráfico

Vamos criar um gráfico de linhas simples, mostrando a variação de temperatura durante uma semana.

\n
1. Importe a biblioteca no seu controlador:\n

   import UIKit\nimport Charts

   \n
\n
2. Adicione uma View no Storyboard ou crie programaticamente:\n

   No storyboard, arraste uma UIView e altere a classe dela para LineChartView no inspetor de identidade (Identity Inspector). Crie um IBOutlet:

   \n

   @IBOutlet weak var lineChartView: LineChartView!

   \n
\n
3. Configure os dados:\n

   func setupLineChart() {\n    // 1. Cria os pontos de dados\n    let dataEntries: [ChartDataEntry] = [\n        ChartDataEntry(x: 1.0, y: 20.0),\n        ChartDataEntry(x: 2.0, y: 22.0),\n        ChartDataEntry(x: 3.0, y: 19.0),\n        ChartDataEntry(x: 4.0, y: 25.0),\n        ChartDataEntry(x: 5.0, y: 23.0),\n        ChartDataEntry(x: 6.0, y: 21.0),\n        ChartDataEntry(x: 7.0, y: 26.0)\n    ]\n\n    // 2. Cria o conjunto de dados\n    let lineDataSet = LineChartDataSet(entries: dataEntries, label: "Temperatura (°C)")\n    lineDataSet.colors = [.systemBlue] // Cor da linha\n    lineDataSet.circleColors = [.systemRed] // Cor dos pontos\n    lineDataSet.circleRadius = 4.0\n    lineDataSet.lineWidth = 2.0\n\n    // 3. Cria o objeto de dados\n    let lineData = LineChartData(dataSet: lineDataSet)\n\n    // 4. Atribui os dados ao gráfico\n    lineChartView.data = lineData\n\n    // 5. Configurações adicionais\