
Demonstrates a library project that generates the Fibonacci sequence from platform-provided numbers and includes tests for each platform. Offers guidance for publishing to Maven Central, including setting up credentials, configuring plugins, and continuous integration with GitHub Actions.
Uma biblioteca Kotlin Multiplatform Mobile (KMM) para gerenciamento eficiente de fluxos de dados e estados entre Android e iOS.
O Cipo Flow KMM foi desenvolvido pela equipe Atlas Software para resolver o desafio de manter fluxos de dados complexos consistentes entre plataformas móveis.
Escrever lógica de estado repetitiva para Android e iOS é propenso a erros. Com o Cipo Flow, você escreve o comportamento do seu fluxo (Cipo) apenas uma vez no módulo compartilhado (KMM) e consome de forma nativa e reativa no Android (via StateFlow/Jetpack Compose) e no iOS (via Combine/SwiftUI).
kotlinx.coroutines e Flow.Combine e concorrência estruturada nativa do Swift (async/await).Adicione a dependência no build.gradle.kts do seu módulo KMM (shared) ou módulo Android:
// build.gradle.kts
sourceSets {
val commonMain by getting {
dependencies {
implementation("dev.atlas-software:cipo-flow-kmm:1.0.0") // Substitua pela versão atual
}
}
}Se você estiver distribuindo o framework nativamente (XCFramework), o Cipo Flow KMM já estará incluído no binário partilhado. Caso utilize o Swift Package Manager (SPM) ou CocoaPods com o seu módulo KMM, nenhuma etapa extra de dependência é necessária além da configuração padrão do KMM.
Crie os seus casos de uso ou viewmodels na camada compartilhada (shared/src/commonMain):
import dev.atlas.cipoflow.CipoFlow
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.asStateFlow
class MeuCipoViewModel {
private val _estado = MutableStateFlow(EstadoDaTela.Carregando)
// O CipoFlow encapsula o Flow padrão para garantir consumo seguro no iOS
val estado = CipoFlow(_estado.asStateFlow())
fun carregarDados() {
// Lógica multiplataforma...
_estado.value = EstadoDaTela.Sucesso("Dados carregados com sucesso!")
}
}
sealed class EstadoDaTela {
object Carregando : EstadoDaTela()
data class Sucesso(val mensagem: String) : EstadoDaTela()
}No Android, consome-se a biblioteca usando as funções nativas do Jetpack Compose de forma fluída:
import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
@Composable
fun MinhaTela(viewModel: MeuCipoViewModel = viewModel()) {
// Collecta o CipoFlow diretamente
val estado by viewModel.estado.collectAsState()
when (val state = estado) {
is EstadoDaTela.Carregando -> LoadingView()
is EstadoDaTela.Sucesso -> TextView(text = state.mensagem)
}
}No iOS, o CipoFlow traduz o fluxo para que o Swift possa observá-lo facilmente usando @Published e Combine, ou concorrência nativa.
import SwiftUI
import SharedModule // O nome do seu módulo KMM gerado
class MeuViewModelIos: ObservableObject {
private let kmmViewModel = MeuCipoViewModel()
@Published var mensagem: String = "Carregando..."
init() {
// Observar mudanças vindas do KMM
kmmViewModel.estado.collect(onEmit: { novoEstado in
if let sucesso = novoEstado as? EstadoDaTela.Sucesso {
DispatchQueue.main.async {
self.mensagem = sucesso.mensagem
}
}
})
}
}
struct MinhaView: View {
@StateObject var viewModel = MeuViewModelIos()
var body: some View {
Text(viewModel.mensagem)
}
}O Cipo Flow KMM atua como uma ponte (bridge) arquitetural. O Kotlin Flow puro muitas vezes possui desafios no momento de ser consumido diretamente via Objective-C/Swift. A nossa biblioteca lida com os detalhes de Dispatcher, cancelamento de Jobs e retém tipos genéricos, deixando as interfaces Swift muito mais limpas.
Nós adoramos contribuições! Para fazer parte, siga estas etapas:
git checkout -b feature/IncrívelFeature).git commit -m 'Adiciona alguma IncrívelFeature').git push origin feature/IncrívelFeature).Certifique-se de ler nossas Diretrizes de Contribuição antes de submeter PRs.
Distribuído sob a licença Apache License 2.0. Veja o arquivo LICENSE para mais detalhes.
Atlas Software Dev
Feito com ❤️ pela equipe Atlas Software
Uma biblioteca Kotlin Multiplatform Mobile (KMM) para gerenciamento eficiente de fluxos de dados e estados entre Android e iOS.
O Cipo Flow KMM foi desenvolvido pela equipe Atlas Software para resolver o desafio de manter fluxos de dados complexos consistentes entre plataformas móveis.
Escrever lógica de estado repetitiva para Android e iOS é propenso a erros. Com o Cipo Flow, você escreve o comportamento do seu fluxo (Cipo) apenas uma vez no módulo compartilhado (KMM) e consome de forma nativa e reativa no Android (via StateFlow/Jetpack Compose) e no iOS (via Combine/SwiftUI).
kotlinx.coroutines e Flow.Combine e concorrência estruturada nativa do Swift (async/await).Adicione a dependência no build.gradle.kts do seu módulo KMM (shared) ou módulo Android:
// build.gradle.kts
sourceSets {
val commonMain by getting {
dependencies {
implementation("dev.atlas-software:cipo-flow-kmm:1.0.0") // Substitua pela versão atual
}
}
}Se você estiver distribuindo o framework nativamente (XCFramework), o Cipo Flow KMM já estará incluído no binário partilhado. Caso utilize o Swift Package Manager (SPM) ou CocoaPods com o seu módulo KMM, nenhuma etapa extra de dependência é necessária além da configuração padrão do KMM.
Crie os seus casos de uso ou viewmodels na camada compartilhada (shared/src/commonMain):
import dev.atlas.cipoflow.CipoFlow
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.asStateFlow
class MeuCipoViewModel {
private val _estado = MutableStateFlow(EstadoDaTela.Carregando)
// O CipoFlow encapsula o Flow padrão para garantir consumo seguro no iOS
val estado = CipoFlow(_estado.asStateFlow())
fun carregarDados() {
// Lógica multiplataforma...
_estado.value = EstadoDaTela.Sucesso("Dados carregados com sucesso!")
}
}
sealed class EstadoDaTela {
object Carregando : EstadoDaTela()
data class Sucesso(val mensagem: String) : EstadoDaTela()
}No Android, consome-se a biblioteca usando as funções nativas do Jetpack Compose de forma fluída:
import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
@Composable
fun MinhaTela(viewModel: MeuCipoViewModel = viewModel()) {
// Collecta o CipoFlow diretamente
val estado by viewModel.estado.collectAsState()
when (val state = estado) {
is EstadoDaTela.Carregando -> LoadingView()
is EstadoDaTela.Sucesso -> TextView(text = state.mensagem)
}
}No iOS, o CipoFlow traduz o fluxo para que o Swift possa observá-lo facilmente usando @Published e Combine, ou concorrência nativa.
import SwiftUI
import SharedModule // O nome do seu módulo KMM gerado
class MeuViewModelIos: ObservableObject {
private let kmmViewModel = MeuCipoViewModel()
@Published var mensagem: String = "Carregando..."
init() {
// Observar mudanças vindas do KMM
kmmViewModel.estado.collect(onEmit: { novoEstado in
if let sucesso = novoEstado as? EstadoDaTela.Sucesso {
DispatchQueue.main.async {
self.mensagem = sucesso.mensagem
}
}
})
}
}
struct MinhaView: View {
@StateObject var viewModel = MeuViewModelIos()
var body: some View {
Text(viewModel.mensagem)
}
}O Cipo Flow KMM atua como uma ponte (bridge) arquitetural. O Kotlin Flow puro muitas vezes possui desafios no momento de ser consumido diretamente via Objective-C/Swift. A nossa biblioteca lida com os detalhes de Dispatcher, cancelamento de Jobs e retém tipos genéricos, deixando as interfaces Swift muito mais limpas.
Nós adoramos contribuições! Para fazer parte, siga estas etapas:
git checkout -b feature/IncrívelFeature).git commit -m 'Adiciona alguma IncrívelFeature').git push origin feature/IncrívelFeature).Certifique-se de ler nossas Diretrizes de Contribuição antes de submeter PRs.
Distribuído sob a licença Apache License 2.0. Veja o arquivo LICENSE para mais detalhes.
Atlas Software Dev
Feito com ❤️ pela equipe Atlas Software