Project "pKizzy"

0.6 のころ (更新履歴)

March 21, 2008:

主な変更は，待望 (誰が？) の日本語リソース追加。

どうして作者 (ちなみに，私のこと) が日本人なのに，今まで日本語リソースを用意してこなかったかというと，バージョンアップする度に２言語分のリソースをメンテしていく手間が面倒だったから。どれか１つ選ぶとすれば，英語がいいかなぁ，と。
なので，日本語リソースを追加したということは，いわば，開発終了宣言と言えなくもない。
不具合などあれば修正はしていくつもり (程度にもよるけど)。
その後，Leopard に固有の不具合をいくつか確認した。
- インクリメンタル・サーチしたときの絞り込み条件を設定するボタンの表示がおかしい。
  ON 状態のボタンは本来，押し込まれたような表示 (黒っぽくなる) になるはずなんだけど，そうならない。カーソルが通過するときは反応する。
  この recessed bezel style のボタンは，Tiger ではコードで指定するしかなくて，Tiger 上ではちゃんと動作するんだけど，Leopard ではおかしくなる。
  Leopard 用にビルドする場合は， IB 上で設定できて，当然 Leopard 上でちゃんと動く。
  recessed button の仕様が変わってしまったのかも。 Leopard 上で正しく動作するように，Tiger 上でコードでどう書けばいいのか，方法はあるかも知れないんだけど，よく分からん。
  ま，状態が把握しづらいだけで，実害はないでしょう。
- NSTokenField も挙動が変わった。
  トークンの内容をメニューで変更しても，表示がすぐに更新されない。内容がちゃんと変更されているのは，プレビューを見ていれば分かる。
  あと，選択範囲 (カーソル位置) の定義も変わったんだろうか。編集中におかしな挙動になる時がある。
  こちらは Leopard でビルドしても同様。
その他もちょこちょこバグ・フィックスしたはずだけど，詳細は忘れた (^^;

今回は，こんなところで。

December 11, 2007:

情報パネルの (ファイル名) "Edit..." ボタンの位置がずれることがあった不具合の修正。(Tiger/Leopard)
単に，IB 上の設定を間違ってた，初歩的なミス (^^;
ドラッグしたアーティクルをドロップできない不具合の修正。(Leopard)
環境によっては Tiger でも起きてたかも。
これも，本来の正しいコーディングをしてれば防げてたバグなんだろうなぁ・・・。
それ以外は，今のところ，だいたいちゃんと機能はしているっぽい。一部，挙動がおかしいところもある。
特に，グループ操作まわりなんか，Tiger よりお行儀よく動いているようだ。
outline view 関係では，Leopard で NSTreeNode というクラスが追加されてたりしてる。要するに必要なパーツが Tiger では欠けてたということ。
tree controller まわりではけっこう苦労したわけだけど・・・やっぱりお前かっ！という感じ。
ちなみに，hpDrafter の方は，今のところ問題なさそうなのでアップデートも保留。

今回はこんなところで。
Leopard 専用版は，ぼちぼち試していく予定。

November 25, 2007:

メモリ・リークのバグを発見したので修正。
0.6.7 で導入されたバグではなく，ずっと抱えていたらしい。
アクティビティ・モニタでチェックしてみたところ，2∼3 MB ぐらいは違いそうなので，修正版を公開することにした。
やっぱり，早く garbage collection に移行した方がよさそうか。
ま，そういうのに頼らず防がないといけない類のバグだったわけだけど (^^;
Bibliographer で作成したリストをエクスポートする際， HTML タイプの bibliographer の場合に RTF 形式のファイルをエクスポートするよう変更。
その過程で，とんでもないことに・・・。詳細は下で。
Bibliographer の編集で，オブジェクト挿入後の選択範囲の不具合を修正。
Source Titles Manager の不具合をいくつか修正。

以下，ひとりごと。
プレーン・テキストをファイル出力するときには NSString の writeToFile: atomically: メソッドを使えばいい。それに対して，アトリビューテッド・テキストを RTF 形式で出力するメソッドは NSString にも NSAttributedString にもなくて，できないと思ってた。
しかし，NSText に writeRTFDToFile: atomically: メソッドを発見。これでできる・・・かと思ったら，これがとんでもない・・・。

このメソッドを使うときには，filename (パス) を指定するわけだけど，そのファイル名のファイルが作られるわけではない。
filename を名前にしたフォルダが作られ，その中に RTF ファイルが作られる。ファイル名は常に "TXT.rtf" ？

filename のファイルやフォルダが存在した場合は，容赦なく上書き。フォルダ内のファイルはすべて消去。
そんなこんなをテストしてる間に，約３年間蓄積してきた PDF やら構築したデータベースが，一瞬で葬り去られてしまった・・・ (T T
・・・Leopard 買お・・・。

で，本当は，NSAttributedString メソッドの Application Kit Additions にある RTFFromRange: documentAttributes: を使って作った NSData から writeToFile: atomically: すればよかったらしい。

今回はこんなところで。

October 25, 2007:

ま，しばらくは導入する余裕ないと思うけど。

威張ることではない (^^;

「グループを追加」「スマート・グループを追加」ボタンのアイコンを変更してみた。
ただし「グループを追加」の方は微妙か。フォルダの形があんまり見えてないし。そもそもグループ・アイコン作るときにフォルダを立てたのが原因の気もする。
というわけで，次バージョンではやめるかも。
あちこちのボタンを NSSegmentedControl に。
単一ボタンも変更して，外見を統一。
ただし実装にはそれなりに困難もありました。詳細は下で。
情報パネルの "edit..." ボタンを押すと

ファイル名編集モードに
filename 編集機能を追加。
基本的に pKizzy では「ファイルの存在は忘れてしまえ」が基本コンセプトなので，ファイル名もいじれなくしてた。
でも，どうしてもファイル自体を扱う必要も出てくるし，ファイル名まで管理したい人もいるかな，とは思ってた。
そんなわけで，編集可能に。

編集は，アーティクルの情報パネル上でのみ可。 Filename 欄の横の "edit..." ボタンを押すと編集モードに入ります。編集終了まで，その他の GUI はロックされ，操作できなくなります。
あくまで例外処理と思ってるので，制限はきつめにしてあります。

このロックのため，bool 変数を用意して，情報パネル上のオブジェクトの enabled を binding することで一括で disable してる。しかし，combo box にはこの binding が効かない。バグ？
というわけで，combo box だけコードで明示的に enabled 制御して解決。
グループ削除時の不具合を修正。
詳細は忘れた (^^;
グループのドラッグ＆ドロップの挙動の修正や最適化なんかも試みてた。しかし，どうも様子がおかしい。
いろいろいじった挙げ句に，とりあえず，ちゃんと動く状態に戻したつもりではいるけど，不具合が残ってるかも。
tree controller のバグか？詳細は下で。
複数ファイルオープン後に NSApplication の replyToOpenOrPrint: メソッドを呼ぶように変更。
効果は不明。 Apple のドキュメントで推奨されてたので，とりあえず入れてみた (^^;

以下，ひとりごと。
segmented control は，ぱっと見，I.B. の GUI や binding でできそうな設定でも，いろいろコードで書く必要がある。具体的には，
- enabled の制御 (setEnabled: forSegment:)
- アイコン使用時のラベル消し (setLabel:nil forSegment:)
  I.B. 上でアイコンは設定できるんだけど，そのままだと中心から微妙に横にずれる。このコードで明示的にラベルのテキストを消してやる必要がある。
- クリック時のアクション ([sender selectedSegment])
- メニューへの接続 (setMenu: forSegment:)
など。とにかく，I.B. が各 segment の設定に対応していないせいか？
Leopard では bindable になってたらいいなぁ・・・。
グループのドラッグ＆ドロップでの並べ替えなんかを最適化しようとしてたら，訳の分からんエラーに出くわすことが多い。
たとえば，
- NSTreeController の removeObjectAtArrangedObjectIndexPath: メソッドを呼んだとき，
  *** -[NSCFString setString:]: nil argument Exception raised during posting of notification. Ignored. exception: *** -[NSCFString setString:]: nil
  とエラーが出る。引数には NSIndexPath オブジェクトを渡しているだけで，string なんて知らんがな。
- *** -[_NSStateMarker boolValue]: selector not recognized [self = 0x308410] Exception raised during posting of notification. Ignored. exception: *** -[_NSStateMarker boolValue]: selector not recognized [self = 0x308410]
  なんていうエラーもよく見るような気が。
  NSStateMarker なんて，リファレンスやドキュメントにも載ってないし，使った覚えはない。
この辺って，NSTreeController のバグだと思うんだけど。これも Leopard では直ってたらいいなぁ・・・。

今回は，こんなところで。

March 27, 2007:

ルート・レベルにグループ (スマートグループ) を追加したときに正常に動作しない場合があった不具合の修正。
実はまだ，グループ追加時に名前が編集状態にならない場合がある不具合が残ってますが，どうやれば解決できるか分からない。ま，実害はないと思われますので・・・。
スマート検索結果をグループに変換した時，新しいグループが正しく挿入されていなかった不具合の修正。
スマート検索ウィンドウで Do It ボタンが押せない場合があった不具合の修正。
隣の NSTextField の方が手前にあるため，ウィンドウを小さくしたとき被ってしまってた。
同梱のプラグインが PowerPC 用だったので，universal binary のものと入れ替えた。
pAMEx pack のエクストラクタは UB だったので，そっちからダウンロードしてもらえていれば問題なかったはず。
UB 移行後に一度開発機の HD がクラッシュしてしまったため，UB ビルド・バージョンが失われてしまってた。その後，ソースやデータは復帰できたんだけど，そのときにビルド設定を変えるのを忘れてた (^^;
スクリーンショットのページを作ってみた。
マニュアル作りをサボってるもんで，簡易マニュアル代わりに見てもらってもいいかなぁ，とも思います。
ぼちぼちと充実させていくつもり・・・のはず・・・かも？ (^^;

今回は，こんなところで。

February 12, 2007:

どうも次回更新を予告したときに限って不具合が見つかってしまうなぁ・・・。
ま，チェックが甘いだけなんだけど (^^;

前回実装した，Apple Script を利用した「ファイルをゴミ箱へ移動」機能の，PowerPC 機で起きる不具合を修正。
Power PC 機ではアプリ起動後に１ファイルしか削除が実行されませんでした。 Intel Mac では大丈夫だった模様。
とはいっても，実際は G4 機 × 2 と intel 機 × 1 でしか確認してないので，どこまで一般論なのか分かりませんが。とりあえず，複数ファイル削除のテストをたまたま MacBook でやったので気付かなかったみたい。
アーティクル-ファイル対応関係チェッカの表示まわりを変更。
具体的には，
- コラムのヘッダを表示
- 横線をやめて交互に色付きの背景色に
- アーティクルの filename 表示
- null placeholder を設定
- テーブル内のアーティクル/ファイルを不選択時にボタンを非アクティブ化
といったところ。
アーティクルに関しては表示されている情報が少ないので，どのアーティクルか特定が難しいかもしれませんが，アーカイブ/ゴミ箱内に表示させるボタンがあるので，その辺を活用してみてください。

今回の変更は，こんなところで。
以下，ひとりごと・・・。
前回書いた，HFS 形式へのパス変換だけど，どうも動作がおかしいので調べてみた。
関連するのは以下の部分。

FSCatalogInfo catalogInfo;

for( n = 0 ; (err == noErr) && (catalogInfo.nodeID != fsRtDirID) && (n < 100) ; n++ ){

err = FSGetCatalogInfo( &fsRef, kFSCatInfoNodeID, &catalogInfo, &names[n], nil, &fsRef );

}

ここでは，指定したファイルからはじまって，階層を１つずつ遡りながら，各階層のディレクトリ (ファイル) 名を names 配列に記録していく。で，ルート・ディレクトリに達したことを青字部分で判定してループを抜ける。

ここで問題は，PowerPC の場合，catalogInfo に前回にこのパス変換関数が呼ばれたときのポインタ値が残っているらしいこと。もしくはランダム値が設定されてエラーになっている？
つまり，２回目以降にこの関数が呼ばれた時には，catalogInfo はルート・ディレクトリの情報を持っているため，いきなりループを抜けることになる。
Intel Mac の場合は，期待通りに動いてくれるみたい。暗黙に，関数が呼ばれるたびに初期化されているのかな。 Apple のドキュメントで説明されていたような気はする (^^;

というわけで，上の部分を下のように書き直して，直ったみたい。

FSCatalogInfo catalogInfo;

n = 0;

do{

err = FSGetCatalogInfo( &fsRef, kFSCatInfoNodeID, &catalogInfo, &names[n++], nil, &fsRef );

}while( (err == noErr) && (catalogInfo.nodeID != fsRtDirID) && (n < 100) ) ;

しかし，Apple のサイトのサンプル・コードのままだと不具合が出るっていうのは，なんだかなぁ・・・。

ちなみに，Apple Script のコマンドに文字数制限はなさそう。
100 個以上のファイルを同時に削除しても，期待通りに動いてくれた。
もっと多い場合は未検証・・・ (^^;

February 6, 2007:

ゴミ箱から削除したアーティクルに対応する PDF ファイルを，ライブラリ・フォルダから削除するタイミングを変更。
これまでは，ゴミ箱からアーティクルを削除した瞬間に削除を実行してましたが，アプリ終了時にまとめて実行するようになりました。
ファイル削除を実行するか，する場合に (Finder の) ゴミ箱に移動するのか直ちに削除するのか，を設定できるようにプリファレンス・パネルも修正。

なんでこんな変更をしたかというと，Core Data の機能のおかげで，ゴミ箱から削除したアーティクルも Undo で復活できるから。
それを許すとなるとファイルも復活しないといけなくなるんだけど，ファイル名が変わってしまっている可能性もあるし，ファイル自体なくなってる可能性もある。それらに対応するのは大変そうだ・・・。
というわけで，アプリ終了時，アーティクルの削除が確定する段階でまとめてファイル移動 (削除) することにしました。

ついでに，ゴミ箱へ移動の処理を，NSFileManager を使った自前のコードから，Apple Script を使う方式に変更。そのため，すでにゴミ箱内に同名のファイルが存在する場合のリネームのスキームが変わります。 Apple Script を使う最大のメリットは，ザンッと音が鳴ることかな (^^
PDF ファイルの１つをリネームして
チェッカを実行した例
アーティクル-ファイル対応関係チェッカを搭載。
で実行可能。
実行すると pKizzy に登録されたアーティクルと "pKizzy Articles" フォルダ内のファイルをすべて調べ，
- 対応するファイルが存在しないアーカイブ内のアーティクル
- 対応するファイルが存在しないゴミ箱内のアーティクル
- 対応するアーティクルが登録されていないファイル
をリストアップします。 PDFless アーティクルは無視されます。
検出されたアーティクルやファイルに対しては，それぞれ３つのボタンでいろいろ対処が可能。

不整合が生じるパターンとしては，たとえば，
- 上で書いてるように，ファイルを削除してからアーティクルだけ Undo で復活させた場合
- ファイルをインポートした時，ファイルは移動されたけどアーティクルの登録は完了しない段階でアプリが落ちた場合 (まだときどき起きるみたい (^^; )
などが考えられる。
このチェッカがあれば，インポートに失敗したときでも，せめてファイルを簡単に見つけることはできるはず。
メイン・ウィンドウの PDF プレビューは，フレームがリサイズされたとき自動的に拡大率を変えるモードがある (fit width と fit page)。
拡大率を直接入力したときやポップ・アップ・メニューから変更したときはこのモードも正しく更新されてたんだけど，「＋」「－」ボタンで変更した後では正しく更新されてなかった。
その不具合を修正。
情報パネルを開いたままアプリを切り替えたとき，タイトル・フィールドにフォーカスが移動する不具合の修正。

情報パネルを開いたときにタイトル・フィールドにフォーカスさせるため，windowDidBecomeKey: メソッド中でフォーカスを移動させてたんだけど，これがアプリ切り替え時にも反応してしまっていたため。
情報パネル上でアーティクルを切り替えるキーボード・ショートカットを cmd + ","/"." から cmd + "["/"]" に変更。
こっちの方が直感的な気がするし，プリファレンス・パネル表示ともバッティングしないし。最初に設定したときは深く考えてなかった (^^;
プリファレンス・パネルの英語表記をいつくか修正。

今回の変更は，こんなところ。
以下，ひとりごと・・・。
今回はじめて，Apple Script を使って Finder にアクセスすることにチャレンジ。
上にも書いたようにファイル削除に使ったのと，不整合チェッカで選択したファイルを表示するのにも使った。
Apple Script を実行するには，ざっくりとこんな感じのコードで OK っぽい。

NSString *asSource = [NSMutableString stringWithString:@"....."];

NSAppleScript *as = [[[NSAppleScript alloc] initWithSource:asSource] autorelease];

NSDictionary *err = nil;

[as executeAndReturnError:&err];

もちろん asSource には @"....." の代わりにちゃんと Apple Script のテキストを設定しないといけません。
Apple Script 自体はよそで勉強してください。実は僕もよく分かってないし (^^;

ここで大問題なのが，Apple Script は UNIX 風のスラッシュ区切りパス表記を受け付けてくれないこと。 "スクリプトエディタ" アプリ上では自動的に変換してくれるんだけど，上に書いたコードでは許してくれない。僕がやり方を知らないだけかもだけど。
たとえば
フォルダを指定しようとすると，
とやらないといけない。鬱陶しい・・・
もしくは HFS 風にコロン区切りで
という感じでもいいらしい。
ただし，HFS 形式のパスを得るのはCocoa だけでは難しいみたい。
このあたり (http://developer.apple.com/jp/technotes/tn2078.html) を参考にすると，エイリアス解決のときのように URL から変換した FSRef 形式のファイル参照を使って，次のようにできるらしい。

FSRef fsRef; ← FSRef は正しく得られているものとする。

CFMutableStringRef hfsPath = CFStringCreateMutable(NULL, 0);

UniChar inSepChar = ':';

FSCatalogInfo catalogInfo;

int i, n;

HFSUniStr255 names[100]; ← ~~パス文字列の長さ~~ パス階層の最大深さはあらかじめ指定

OSStatus err = noErr;

for( n = 0 ; (err == noErr) && (catalogInfo.nodeID != fsRtDirID) && (n < 100) ; n++ ){

err = FSGetCatalogInfo( &fsRef, kFSCatInfoNodeID, &catalogInfo, &names[n], nil, &fsRef );

}

for( i = n - 1; i >= 0 ; --i ){

CFStringAppendCharacters( hfsPath, names[i].unicode, names[i].length );

if ( i > 0 )

CFStringAppendCharacters( hfsPath, &inSepChar, 1 );

}

これで得られる hfsPath は CFString なので NSString に toll free でキャストして使えます。

Apple Script に渡す文字列に文字数制限はあるんだろうかとか，HFS 以外のフォーマットのボリュームでも有効なんだろうかとか，未検証の部分もありますが・・・ま，いいか (^^;
といったところで，次の更新は Leopard 後ぐらいかな？
まだときどき落ちることがあるので，garbage collection 導入で安定化・・・できたりするといいなぁ・・・ (他人事か？ (^^; )。

ただ，こないだの MacWorld では Leopard にはまったく触れられなかったみたい。
当面買えない，買っても使えない iPhone (現地で買ってきて PDA として使う手はあるかもだけど) より，当面買うつもりのない AppleTV より，Leopard の話が聞きたかったのに・・・残念。

October 19, 2006:

Source Titles Manager で，permanent 設定の情報を保存できていなかった (厳密には，アプリ起動時に読み込めていなかった) 不具合の修正。
Bibliographer で，source プロパティの省略形 ↔ 非省略形変換が正しく機能していなかった不具合の修正。
ただし，アプリ起動後に一度でも Source Titles Manager ウィンドウを開けば，その後は機能していたはず。
Bibliographer Manager でプロパティ・タグの挿入操作をポップ・アップ・ボタン方式に変更。
これで，プロパティをダイレクトに選択しつつ挿入することが可能になりました。
ただし，UI 的にボタンの外観の統一感がなくなってしまったわけだけど・・・。 square で small の pop up button が IB 上で設定できるようになったら，直します，きっと。
５月に買ったばかりの MacBook のハードディスクがクラッシュ・・・ (T T
しかも修理に出したら３週間以上かかってしまった。
作業報告書を見ると，ハードディスク交換の他にも，以下３カ所のパーツ交換があった模様。
- トップケース (パームレストが汚れる現象があったため (うちの Mac では問題なかったけど))
- ディスプレイベゼル (液晶パネル固定枠の，パームレストにあたる部分。トップケース交換とセット？)
- CPU ヒートシンク (発熱異常による電源遮断が発生することがある)
このせいで時間がかかったらしい。同時期に買った MacBook には同じ問題があるのかも。

ま，本業用の Mac ではなかったし，以前の iBook から移行アシスタントでデータを移せたから，不幸中の幸いとは言えたかも。バックアップしとかないといけないのは分かってるんだけど・・・。

ちなみに，トップケース交換で，クリックボタンとカーソルキーの接触が悪かったのも直ったみたい。

今回は，こんなところで・・・。

August 20, 2006:

アーティクル・テーブル・ビューやグループ・アウトライン・ビューで，デリート・キーだけで項目を削除できるように変更。
グループを削除した場合に，アーティクル・テーブル・ビューの表示がおかしくなっていた不具合の修正。
スマートグループを子 (またはその下の子孫) に含むグループを削除した後でクラッシュする (可能性があった) 不具合の修正。
可能性，と断ってるのは，実際にうちの環境で起きたわけではないから。でもソースを見る限りヤバそうだったから，被害を受けていた人はいそう。
グループのドラッグ＆ドロップ処理の不具合を修正。
Core Data 化するときに，あんまりよく分かってないまま，いちおう動いてるかと思って公開してたんだけど，やっぱりバグってたらしい (^^;

修正点としては，
- ゴミ箱にドラッグ＆ドロップしても削除できていなかった不具合の修正。
- ドラッグ＆ドロップ移動の内部処理を修正。
  今まで，挙動がおかしいことがあったはず。
- アーカイブ・グループとゴミ箱をドラッグできないように変更。
  そうしてたつもりだったんだけど，忘れてたらしい (^^;
といったところ。
他にもあるかも？ (^^;
article なし articleIndex オブジェクトが作られていることがあった (とくにスマート・グループ内？) ので，アプリ起動時に削除するようにした。
いつどこで作られたか特定できていないんだけど，いずれそっちも見つけて修正しないといけないかも。

今回は，こんなところで。

June 27, 2006:

File > Empty Trash メニューからゴミ箱を空にしようとするとクラッシュするバグの修正。
バグ報告いただきました。ありがとうございました m(_ _)m
インクリメンタル・サーチの Spotlight スイッチを，オフの状態をデフォルトに変更。

今回は，そんなところで。

May 25, 2006:

いよいよ待望 (誰が？) の，Universal Binary バージョンです。
ビルドし直しただけで，動作テストはあんまりできてないですが (^^;
pAMEx プラグインも，すべて Universal Binary にバージョン・アップ。

ちなみに，中身はまったく変わってませんが，intel Mac で Universal 版の pKizzy を使ってる場合は，プラグインも Universal じゃないと動きません。