CoreDataのmigration方法
こんにちは! りーさんです^_^
最近、リリース後のアプリでCoreDataの既存のEntitiesにAttribute追加する改修があって、マイグレーションする機会があったのでここに方法をメモしておきます!
マイグーション手順
xcdatamodelファイル作成
xcdatamodelバージョン設定
既存のCoreDataVer2のEntitiesにAttributeを追加
DataMappingModelファイル作成
最後にマイグレーションできているかチェック!
今回のサンプルデータ
CoreDataSampleAppの中にCoreDataSample. xcdatamodelがあり、
ItemというEntitiesのAttributesがid・title・memoがあるものがあります。
こちらのCoreDataをアプリリリースしたとします!
この後の手順は、アプリリリース後に改修で必要になった既存のEntitiesのAttributeを追加するための手順を記します。
手順1 xcdatamodelファイル作成
CoreDataSample.xcdatamodelをクリックしてから、Xcodeメニュー(上)
Editor -> Add Model Version..を選択します。
version nameを入力するフォームが出るのでわかりやすくCoreDataSample Ver2という名前に設定します。 Based on modelはそのままで大丈夫です。
先ほどのをFinishするとCoreDataSample Ver2.xcdatamodelが作成されたのがわかります。ファイル名のアイコンにチェックが入っているのが使っている構造データにチェックが入ります。
手順2 xcdatamodelバージョン設定
CoreDataSample ver2をクリックして右のModel VersionのCurrentをCoreDataSample ver2に変更してください。
そうすると左のファイルアイコンにチェックがつきます!
手順3 既存のCoreDataVer2EntitiesにAttribute追加
CoreDataSample Ver2.xcdatamodelをクリックしたら、既存のCoreDataSample.xcdatamodelと全く同じEntitiesとAttributeが表示されているので
Ver2の方に追加したいAttributeを追加していきます。
今回は元々あったid・title・memoに加え、subTitle・createdAtを追加します。
手順4 DataMappingModelファイル作成
Attributeの追加ができたら、いつも通りSwiftファイルを追加するようにadd filleして
Mappingで検索します。 Mapping Modelファイルを選択しNextを押しましょう!
上記の画面が出たら既存のCoreDataSample.xcdatamodelを選択して、Nextです。
次の画面は新規のCoreDataSample ver2.xcdatamodelを選択し、Nextです。
Mapping Modelのファイル名をわかりやすくCoreDataSampleVer1toVer2と設定し、Createします。
これでCoreDataSampleVer1toVer2のMappingModelが作成されたことがわかります。これでマイグレーションの手順は以上になります。
最後にマイグレーションできているかチェック!
上記の手順が全てできたら、マイグレーションができているかチェックしてみます。
まず、ビルドしてみて既存の構造データのものを閲覧してもクラッシュしないか見ます。問題なければ、新しいデータを追加してみて、新規の構造データのものと既存の構造データの値を出力してみて、大丈夫であれば無事にマイグレーション完了です!!
お疲れ様でした!!何か間違っていたらご指摘お願いします🙇
この記事が気に入ったらサポートをしてみませんか?