Skip to content

Latest commit

 

History

History
322 lines (222 loc) · 11.9 KB

CHANGELOG.md

File metadata and controls

322 lines (222 loc) · 11.9 KB

x.x.x Release notes (yyyy-MM-dd)

API breaking changes

  • None.

Enhancements

  • None.

Bugfixes

  • Improved Unicode support in property names and string contents (Chinese, Russian, etc.). Closing #612 and #604.
  • Potential bugs fixed related to migration when properties are removed.
  • Fixed keyed subscripting for standalone RLMObjects.

0.80.0 Release notes (2014-07-15)

API breaking changes

  • Rename migration methods to -migrateDefaultRealmWithBlock: and -migrateRealmAtPath:withBlock:
  • Moved Realm specific query methods from RLMRealm to class methods on RLMObject (-allObjects: to +allObjectsInRealm: ect.)

Enhancements

  • Added +createInDefaultRealmWithObject: method to RLMObject.
  • Added support for array and object literals when calling -createWithObject: and -initWithObject: variants.
  • Added method -deleteObjects: to batch delete objects from a Realm
  • Support for defining RLMObject models entirely in Swift (experimental, see known issues).
  • RLMArrays in Swift support Sequence-style enumeration (for obj in array).
  • Implemented -indexOfObject: for RLMArray

Known Issues for Swift-defined models

  • Properties other than String, NSData and NSDate require a default value in the model. This can be an empty (but typed) array for array properties.
  • The previous caveat also implies that not all models defined in Objective-C can be used for object properties. Only Objective-C models with only implicit (i.e. primitives) or explicit default values can be used. However, any Objective-C model object can be used in a Swift array property.
  • Array property accessors don't work until its parent object has been added to a realm.
  • Realm-Bridging-Header.h is temporarily exposed as a public header. This is temporary and will be private again once rdar://17633863 is fixed.
  • Does not leverage Swift generics and still uses RLM-prefix everywhere. This is coming in #549.

0.22.0 Release notes

API breaking changes

  • Rename schemaForObject: to schemaForClassName: on RLMSchema
  • Removed -objects:where: and -objects:orderedBy:where: from RLMRealm
  • Removed -indexOfObjectWhere:, -objectsWhere: and -objectsOrderedBy:where: from RLMArray
  • Removed +objectsWhere: and +objectsOrderedBy:where: from RLMObject

Enhancements

  • New Xcode 6 project for experimental swift support.
  • New Realm Editor app for reading and editing Realm db files.
  • Added support for migrations.
  • Added support for RLMArray properties on objects.
  • Added support for creating in-memory default Realm.
  • Added -objectsWithClassName:predicateFormat: and -objectsWithClassName:predicate: to RLMRealm
  • Added -indexOfObjectWithPredicateFormat:, -indexOfObjectWithPredicate:, -objectsWithPredicateFormat:, -objectsWithPredi
  • Added +objectsWithPredicateFormat: and +objectsWithPredicate: to RLMObject
  • Now allows predicates comparing two object properties of the same type.

0.20.0 Release notes (2014-05-28)

Completely rewritten to be much more object oriented.

API breaking changes

  • Everything

Enhancements

  • None.

Bugfixes

  • None.

0.11.0 Release notes (not released)

The Objective-C API has been updated and your code will break!

API breaking changes

  • RLMTable objects can only be created with an RLMRealm object.
  • Renamed RLMContext to RLMTransactionManager
  • Renamed RLMContextDidChangeNotification to RLMRealmDidChangeNotification
  • Renamed contextWithDefaultPersistence to managerForDefaultRealm
  • Renamed contextPersistedAtPath: to managerForRealmWithPath:
  • Renamed realmWithDefaultPersistence to defaultRealm
  • Renamed realmWithDefaultPersistenceAndInitBlock to defaultRealmWithInitBlock
  • Renamed find: to firstWhere:
  • Renamed where: to allWhere:
  • Renamed where:orderBy: to allWhere:orderBy:

Enhancements

  • Added countWhere: on RLMTable
  • Added sumOfColumn:where: on RLMTable
  • Added averageOfColumn:where: on RLMTable
  • Added minOfProperty:where: on RLMTable
  • Added maxOfProperty:where: on RLMTable
  • Added toJSONString on RLMRealm, RLMTable and RLMView
  • Added support for NOT operator in predicates
  • Added support for default values
  • Added validation support in createInRealm:withObject:

Bugfixes

  • None.

0.10.0 Release notes (2014-04-23)

TightDB is now Realm! The Objective-C API has been updated and your code will break!

API breaking changes

  • All references to TightDB have been changed to Realm.
  • All prefixes changed from TDB to RLM.
  • TDBTransaction and TDBSmartContext have merged into RLMRealm.
  • Write transactions now take an optional rollback parameter (rather than needing to return a boolean).
  • addColumnWithName: and variant methods now return the index of the newly created column if successful, NSNotFound otherwise.

Enhancements

  • createTableWithName:columns: has been added to RLMRealm.
  • Added keyed subscripting for RLMTable's first column if column is of type RLMPropertyTypeString.
  • setRow:atIndex: has been added to RLMTable.
  • RLMRealm constructors now have variants that take an writable initialization block
  • New object interface - tables created/retrieved using tableWithName:objectClass: return custom objects

Bugfixes

  • None.

0.6.0 Release notes (2014-04-11)

API breaking changes

  • contextWithPersistenceToFile:error: renamed to contextPersistedAtPath:error: in TDBContext
  • readWithBlock: renamed to readUsingBlock: in TDBContext
  • writeWithBlock:error: renamed to writeUsingBlock:error: in TDBContext
  • readTable:withBlock: renamed to readTable:usingBlock: in TDBContext
  • writeTable:withBlock:error: renamed to writeTable:usingBlock:error: in TDBContext
  • findFirstRow renamed to indexOfFirstMatchingRow on TDBQuery.
  • findFirstRowFromIndex: renamed to indexOfFirstMatchingRowFromIndex: on TDBQuery.
  • Return NSNotFound instead of -1 when appropriate.
  • Renamed castClass to castToTytpedTableClass on TDBTable.
  • removeAllRows, removeRowAtIndex, removeLastRow, addRow and insertRow methods on table now return void instead of BOOL.

Enhancements

  • A TDBTable can now be queried using where: and where:orderBy: taking NSPredicate and NSSortDescriptor as arguments.
  • Added find: method on TDBTable to find first row matching predicate.
  • contextWithDefaultPersistence class method added to TDBContext. Will create a context persisted to a file in app/documents folder.
  • renameColumnWithIndex:to: has been added to TDBTable.
  • distinctValuesInColumnWithIndex has been added to TDBTable.
  • dateIsBetween::, doubleIsBetween::, floatIsBetween:: and intIsBetween:: have been added to TDBQuery.
  • Column names in Typed Tables can begin with non-capital letters too. The generated addX selector can look odd. For example, a table with one column with name age, appending a new row will look like [table addage:7].
  • Mixed typed values are better validated when rows are added, inserted, or modified as object literals.
  • addRow, insertRow, and row updates can be done using objects derived from NSObject.
  • where has been added to TDBViewand TDBViewProtocol.
  • Adding support for "smart" contexts (TDBSmartContext).

Bugfixes

  • Modifications of a TDBView and TDBQuery now throw an exception in a readtransaction.

0.5.0 Release notes (2014-04-02)

The Objective-C API has been updated and your code will break! Of notable changes a fast interface has been added. This interface includes specific methods to get and set values into Tightdb. To use these methods import <Tightdb/TightdbFast.h>.

API breaking changes

  • getTableWithName: renamed to tableWithName: in TDBTransaction.
  • addColumnWithName:andType: renamed to addColumnWithName:type: in TDBTable.
  • columnTypeOfColumn: renamed to columnTypeOfColumnWithIndex in TDBTable.
  • columnNameOfColumn: renamed to nameOfColumnWithIndex: in TDBTable.
  • addColumnWithName:andType: renamed to addColumnWithName:type: in TDBDescriptor.
  • Fast getters and setters moved from TDBRow.h to TDBRowFast.h.

Enhancements

  • Added minDateInColumnWithIndex and maxDateInColumnWithIndex to TDBQuery.
  • Transactions can now be started directly on named tables.
  • You can create dynamic tables with initial schema.
  • TDBTable and TDBView now have a shared protocol so they can easier be used interchangeably.

Bugfixes

  • Fixed bug in 64 bit iOS when inserting BOOL as NSNumber.

0.4.0 Release notes (2014-03-26)

API breaking changes

  • Typed interface Cursor has now been renamed to Row.
  • TDBGroup has been renamed to TDBTransaction.
  • Header files are renamed so names match class names.
  • Underscore (_) removed from generated typed table classes.
  • TDBBinary has been removed; use NSData instead.
  • Underscope (_) removed from generated typed table classes.
  • Constructor for TDBContext has been renamed to contextWithPersistenceToFile:
  • Table findFirstRow and min/max/sum/avg operations has been hidden.
  • Table.appendRow has been renamed to addRow.
  • getOrCreateTable on Transaction has been removed.
  • set*:inColumnWithIndex:atRowIndex: methods have been prefixed with TDB
  • *:inColumnWithIndex:atRowIndex: methods have been prefixed with TDB
  • addEmptyRow on table has been removed. Use [table addRow:nil] instead.
  • TDBMixed removed. Use id and NSObject instead.
  • insertEmptyRow has been removed from table. Use insertRow:nil atIndex:index instead.

Enhancements

  • Added firstRow, lastRow selectors on view.
  • firstRow and lastRow on table now return nil if table is empty.
  • getTableWithName selector added on group.
  • getting and creating table methods on group no longer take error argument.
  • [TDBQuery parent] and [TDBQuery subtable:] selectors now return self.
  • createTable method added on Transaction. Throws exception if table with same name already exists.
  • Experimental support for pinning transactions on Context.
  • TDBView now has support for object subscripting.

Bugfixes

  • None.

0.3.0 Release notes (2014-03-14)

The Objective-C API has been updated and your code will break!

API breaking changes

  • Most selectors have been renamed in the binding!
  • Prepend TDB-prefix on all classes and types.

Enhancements

  • Return types and parameters changed from size_t to NSUInteger.
  • Adding setObject to TightdbTable (t[2] = @[@1, @"Hello"] is possible).
  • Adding insertRow to TightdbTable.
  • Extending appendRow to accept NSDictionary.

Bugfixes

  • None.

0.2.0 Release notes (2014-03-07)

The Objective-C API has been updated and your code will break!

API breaking changes

  • addRow renamed to addEmptyRow

Enhancements

  • Adding a simple class for version numbering.
  • Adding get-version and set-version targets to build.sh.
  • tableview now supports sort on column with column type bool, date and int
  • tableview has method for checking the column type of a specified column
  • tableview has method for getting the number of columns
  • Adding methods getVersion, getCoreVersion and isAtLeast.
  • Adding appendRow to TightdbTable.
  • Adding object subscripting.
  • Adding method removeColumn on table.

Bugfixes

  • None.

Template follows:

x.x.x Release notes (yyyy-MM-dd)

?? summary

API breaking changes

  • None.

Enhancements

  • None.

Bugfixes

  • None.