0.7.4 #

• Bump Android and Firebase dependency versions.

0.7.3 #

• Updated Gradle tooling to match Android Studio 3.1.2.

0.7.2 #

• Fixes crash on Android if a FirebaseFirestoreException happened.

0.7.1 #

• Updated iOS implementation to reflect Firebase API changes.
• Fixed bug in Transaction.get that would fail on no data.
• Fixed error in README.md code sample.

0.7.0+2 #

• Update transactions example in README to add await.

0.7.0+1 #

• Add transactions example to README.

0.7.0 #

• Breaking change. snapshots is now a method instead of a getter.
• Breaking change. setData uses named arguments instead of SetOptions.

0.6.3 #

• Updated Google Play Services dependencies to version 15.0.0.

0.6.2 #

• Support for BLOB data type.

0.6.1 #

• Simplified podspec for Cocoapods 1.5.0, avoiding link issues in app archives.

0.6.0 #

• Breaking change. Renamed 'getCollection()' to 'collection().'

0.5.1 #

• Expose the Firebase app corresponding to a Firestore
• Expose a constructor for a Firestore with a non-default Firebase app

0.5.0 #

• Breaking change. Move path getter to CollectionReference
• Add id getter to CollectionReference

0.4.0 #

• Breaking change. Hide Firestore codec class from public API.
• Adjusted Flutter SDK constraint to match Flutter release with extensible platform message codec, required already by version 0.3.1.
• Move each class into separate files

0.3.2 #

• Support for batched writes.

0.3.1 #

• Add GeoPoint class
• Allow for reading and writing DocumentReference, DateTime, and GeoPoint values from and to Documents.

0.3.0 #

• Breaking change. Set SDK constraints to match the Flutter beta release.

0.2.12 #

• Fix handling of null document snapshots (document not exists).
• Add DocumentSnapshot.exists.

0.2.11 #

• Fix Dart 2 type errors.

0.2.10 #

• Fix Dart 2 type errors.

0.2.9 #

• Relax sdk upper bound constraint to '<2.0.0' to allow 'edge' dart sdk use.

0.2.8 #

• Support for Query.getDocuments

0.2.7 #

• Add transaction support.

0.2.6 #

• Build fixes for iOS
• Null checking in newly added Query methods

0.2.5 #

• Query can now have more than one orderBy field.
• startAt, startAfter, endAt, and endBefore support
• limit support

0.2.4 #

• Support for DocumentReference.documentID
• Support for CollectionReference.add

0.2.3 #

• Simplified and upgraded Android project template to Android SDK 27.
• Updated package description.

0.2.2 #

• Add get to DocumentReference.

0.2.1 #

• Fix bug on Android where removeListener is sometimes called without a handle

0.2.0 #

• Breaking change. Upgraded to Gradle 4.1 and Android Studio Gradle plugin 3.0.1. Older Flutter projects need to upgrade their Gradle setup as well in order to use this version of the plugin. Instructions can be found here.
• Relaxed GMS dependency to [11.4.0,12.0[

0.1.2 #

• Support for DocumentReference update and merge writes
• Suppress unchecked warnings and package name warnings on Android

0.1.1 #

• Added FLT prefix to iOS types.

0.1.0 #

• Added reference to DocumentSnapshot
• Breaking: removed path from DocumentSnapshot
• Additional test coverage for reading collections and documents
• Fixed typo in DocumentChange documentation

0.0.6 #

• Support for getCollection

0.0.5 #

• Support isNull filtering in Query.where
• Fixed DocumentChange.oldIndex and DocumentChange.newIndex to be signed integers (iOS)

0.0.4 #

• Support for where clauses
• Support for deletion

0.0.3 #

• Renamed package to cloud_firestore

0.0.2 #

• Add path property to DocumentSnapshot

0.0.1+1 #

• Update project homepage

0.0.1 #

• Initial Release

example/lib/main.dart

// Copyright 2017, the Chromium project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> main() async {
  final FirebaseApp app = await FirebaseApp.configure(
    name: 'test',
    options: const FirebaseOptions(
      googleAppID: '1:79601577497:ios:5f2bcc6ba8cecddd',
      gcmSenderID: '79601577497',
      apiKey: 'AIzaSyArgmRGfB5kiQT6CunAOmKRVKEsxKmy6YI-G72PVU',
      projectID: 'flutter-firestore',
    ),
  );
  final Firestore firestore = new Firestore(app: app);

  runApp(new MaterialApp(
      title: 'Firestore Example', home: new MyHomePage(firestore: firestore)));
}

class MessageList extends StatelessWidget {
  MessageList({this.firestore});

  final Firestore firestore;

  @override
  Widget build(BuildContext context) {
    return new StreamBuilder<QuerySnapshot>(
      stream: firestore.collection('messages').snapshots(),
      builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
        if (!snapshot.hasData) return const Text('Loading...');
        final int messageCount = snapshot.data.documents.length;
        return new ListView.builder(
          itemCount: messageCount,
          itemBuilder: (_, int index) {
            final DocumentSnapshot document = snapshot.data.documents[index];
            return new ListTile(
              title: new Text(document['message'] ?? '<No message retrieved>'),
              subtitle: new Text('Message ${index + 1} of $messageCount'),
            );
          },
        );
      },
    );
  }
}

class MyHomePage extends StatelessWidget {
  MyHomePage({this.firestore});
  final Firestore firestore;
  CollectionReference get messages => firestore.collection('messages');

  Future<Null> _addMessage() async {
    final DocumentReference document = messages.document();
    document.setData(<String, dynamic>{
      'message': 'Hello world!',
    });
  }

  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: new AppBar(
        title: const Text('Firestore Example'),
      ),
      body: new MessageList(firestore: firestore),
      floatingActionButton: new FloatingActionButton(
        onPressed: _addMessage,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}