MindTo01s

キーボードショートカットのデバッグ用コード

Mon, 17 Feb 2020 00:00:00 +0900

キーボードショートカットのデバッグ用コード

タイトルそのまま。ソース有り、解説なし。

KeyTouchViewer.zip

非公開APIを使わない、Migemoみたいな逐次検索

Tue, 29 Oct 2019 00:00:00 +0900

非公開APIを使わない、Migemoみたいな逐次検索

Cocoa勉強会2019/10/29の資料。

Cocoa_2019-10-30.zip を解凍すること。

辞書データはライセンスの関係で添付していない。

TSMが変換候補を表示しているか否かの判定

Thu, 19 Sep 2019 00:00:00 +0900

TSMが変換候補を表示しているか否かの判定

TSMが変換候補を評しているか否かを返す。 trueの場合は変換候補の表示中。

extension NSApplication
{
    @objc var isShowInputManagerPanel: Bool
    {
        return self.windows.first(where:{$0.className == "NSPanelViewBridge"}) != nil
    }
}

ローマ字かな変換表

Mon, 16 Sep 2019 00:00:00 +0900

ローマ字かな変換表

ローマ字かな変換規則には、ヘボン式、訓令式、日本式の3つがある。

MacOSXのデフォルトのインプットメソッドでは、上記のどれでもない方式を採用している。

CFStringTransformよりも柔軟な変換が必要なために、変換規則の詳細を知る必要があったので調べていると、以下のパスに変換表があった。

“/System/Library/Input Methods/JapaneseIM.app/Contents/PlugIns/JapaneseIM.appex/Contents/Resources/RomajiRule_Default.txt”

同じディレクトリに、”RomajiRule_Kotoeri.txt”と”RomajiRule_Windows.txt”もあったが、kotoeriはおそらく古いMacOSXの変換規則が記載されている。windowsは文字どうりWindiwsの変換規則なのだろう。

NSTextViewにCommand Paletteをつける

Thu, 29 Aug 2019 00:00:00 +0900

NSTextViewにCommand Paletteをつける

Cocoa勉強会2019/09/11の資料。

ソースコードだけ、資料は頭が回らない。あと、よく落ちるバグ付き。

CommandPalette.zip を解凍すること。

ソースコードの動作はムービーで動作確認したほうが早い( CommandPalette.mov )

エアコンはフィルターを掃除したら治った。

午前1時、室温は29度。エアコンの調子がおかしい。

Sun, 04 Aug 2019 00:00:00 +0900

午前1時、室温は29度。エアコンの調子がおかしい。

すごく、恐怖を感じる。

NSUserDefaultsControllerでbinding出来るデータ構造についてのメモ

Tue, 30 Jul 2019 00:00:00 +0900

NSUserDefaultsControllerでbinding出来るデータ構造についてのメモ

NSUserDefaultsControllerとcocoa bindingを使い、初期設定WindowのUIを作ろうとして失敗した。その失敗についての箇条書きのメモ

NSUserDefaultsが持っているデータ構造は、plist形式と考えて良い。
NSUserDefaultsがデータ構造に情報を溜め込むアクセッサ、setStringやsetIntgerなどは、keyを指定し、keyPathではない。
plistなデータ構造の深い位置にアクセスするにはkeyPathで指定できるべきである。
NSUserDefaultsで保持するデータは、keyで指定可能な位置の物は、mutableである。keyPathが必要な場所は、immutableになっているように見える。
ググると、mutableCopyした後に変更を加えて、setObjectしている事例がいくつかある。
NSUserDefaultsControllerは、深い階層へのPathのアクセスの不具合や、immutableなArrayやdictonaryの問題を解決するわけではない。
NSUserDefaultsControllerで使うPathは”values.key”のようにドットは1つまでにする必要がある。”value.key1.key2”のようにする、中間のimmutableなobjectがKVOに対応していないとログに警告とエラーが出る。
泥臭い解決方法は、plist形式と言いつつ、最初の階層だけのフラットな構造にすると良い。”values.key1.key2”を”values.key1_key2”のようにする。
NSUserDefaultsControllerのselectedObjectにさらにNSArrayControllerを噛ませて、TableViewで表示する方法は、NSUserDefaultsControllerがNSArrayController側の変更を検知できないようだ。
おそらく、NSUserDefaultsControllerで取得した値をdeepMutableCopyして、ViewControllerに持たせ、そのデータが変わった時に、NSUserDefaultsControllerに反映させる方法が良いようだ。

もうやり気が出ない。

室温が30度を超える。

Thu, 25 Jul 2019 00:00:00 +0900

室温が30度を超える。

平年並みとの事。頭痛がするほど暑く感じる。

扇風機だけでは頭が働かない。仕事部屋にクーラーが欲しい。

Symbol font を使う

Mon, 15 Jul 2019 00:00:00 +0900

Symbol font を使う

Cocoa勉強会2019/07/17の資料。

SymbolFontを使うためにpngファイルを出力するソースコードと資料。

SymbolFontApp.zip を解凍すること。

NSUserDefaultsControllerでUndo/Redo

Sun, 14 Jul 2019 00:00:00 +0900

NSUserDefaultsControllerでUndo/Redo

Cocoa勉強会2019/07/17の資料。

NSUserDefaultsControllerでUndo/Redoさせるためのソースコードと資料。

NSUserDefaultsController&UndoRedo.zip を解凍すること。

DocumentとDefault

Mon, 03 Jun 2019 00:00:00 +0900

DocumentとDefault

Cocoa勉強会2019/06/12の資料。

DocumentDefaultsを解説するためのソースコードと資料。

DocumentDefault.zip を解凍すること。

なお、元ネタは”CoreData Apple’s API for Persisting Data on Mac OSX”のP255からの、”Dynamic Parameters”。コードはObjective-Cに出来るだけ似せているつもり。

元の本のswift版がすでに出ているようだがそちらは入手していない。

CoreDataとDrag&Drop

Mon, 22 Apr 2019 00:00:00 +0900

CoreDataとDrag&Drop

Cocoa勉強会2019/04/25の資料。

CoreDataとDrag&Dropを解説するためのソースコード。

memoList.zip を解凍すること。

ソースコードだけで、解説はなし。

Tab機能の拡張を諦める。

Sat, 23 Feb 2019 00:00:00 +0900

Tab機能の拡張を諦める。

VisualにTabを選択したいため、タブを一覧表示で、カレントなWindowを示すコードを書こうとした。

一応、以下の非公開メソッドを使うことでできそうだが実装は諦める。

tabの切り替えのための over view の画面は格好良いけど、”select next tab”にショートカットをつける方が画面がすぐに変わるので便利だ。

つまり、以下のコードを無駄。

@IBAction func log(_ sender: Any?)
{
    if let theStack = self.window!.value(forKeyPath:
        "windowStackController.tabPickerViewController.tabPickerController" ) as? NSViewController
    {
        if let orderedTabViewItems = theStack.value(forKey: "orderedTabViewItems") as? NSArray
        {
            if let indexOfSelectedTab = theStack.value(forKey: "indexOfSelectedTab") as? NSNumber
            {
                if let theSelectedObject = orderedTabViewItems.object(at: indexOfSelectedTab.intValue) as? NSObject
                {
                    // タイトルを" this is a Current Tab "に変更
                    theSelectedObject.setValue("this is a Current Tab", forKey: "label")
                    // 再描画させる
                    theStack.perform(NSSelectorFromString("reloadTabBarItem:"), with: theSelectedObject)
                }
            }
        }
    }
}

Servicesメニューの実装

Fri, 08 Feb 2019 00:00:00 +0900

Servicesメニューの実装

Cocoa勉強会2019/02/20の資料。NSServicesメニューの実装の説明。

プロジェクトファイルは、 NSServicesメニューの実装.zip に置いておきます。

ヒレガス本 21章課題1 swift版

Wed, 06 Feb 2019 00:00:00 +0900

ヒレガス本 21章課題1 swift版

昨日のヒレガス本の課題をswiftへ移植。あまり綺麗なコードにはならなかった。

それぞれのメソッドを地道に移植した。注意事項はない。必要なのは努力だけ。

プロジェクトファイルは、 TypingTutor_swift.zip に置いておきます。

ヒレガス本 21章課題1

Tue, 05 Feb 2019 00:00:00 +0900

ヒレガス本 21章課題1

サンプルコードの雛形が欲しかったので、久しぶりにヒレがス本の課題の続きを行なった。

第21章でBigLetterViewにコピー＆ペースト機能をつけた。

課題は、コピー時に、テキストだけでなくPDFもペーストボードに書き込めとのこと。

単純にwriteToPasteboardメソッドを書き換える。

- (void)writeToPasteboard:(NSPasteboard*)pb
{
    [pb clearContents];

    // pdfデータの準備
    NSData* thePDFData  = [self dataWithPDFInsideRect:self.bounds];

    NSPasteboardItem* thePDFItem = [[NSPasteboardItem alloc] init];
    [thePDFItem setData:thePDFData forType:NSPasteboardTypePDF];

    NSPasteboardItem* theTextItem = [[NSPasteboardItem alloc] init];
    [theTextItem setString:self.string forType:NSPasteboardTypeString];

    [pb writeObjects:@[thePDFItem, theTextItem]];
}

一種類のデータだけならば、NSPasteboardを使うだけで良いが、複数のデータを扱う場合は、NSPasteboardItemを使う必要がある。

プロジェクトファイルは、 TypingTutor_3.zip に置いておきます。

Cellを使ったControllサブクラス化

Wed, 16 Jan 2019 00:00:00 +0900

Cellを使ったControllサブクラス化

Cocoa勉強会2019/01/16の資料。NSCellの説明。

ソースはこれ。( Cellを使ったControllサブクラス化.zip.zip )

CocoaでPACパターン

Tue, 15 Jan 2019 00:00:00 +0900

CocoaでPACパターン

Cocoa勉強会2019/01/16の資料。PACパターンの説明。

ソースはこれ。( PACパターンサンプル.zip )

FontWellの再実装

Fri, 28 Dec 2018 00:00:00 +0900

FontWellの再実装

FontWellをswiftで再実装した。

BSFontWellを参考にしたつもりで、NSButtonとNSButtonCellのサブクラスから作成した。

Interface builder関連のコードやcocoa binding関連のコードを変更したら、BSFontWellとはコード上の関連は無くなってしまった。その上、コードの意味が分かりにくくなった気がする。

ソースはこれ。( ControlSikenjo3.zip )

IB上からのbindingの設定方法

“value”等の既存の値でGUI上でbindingを作る。
“open as”で、.xibや.storybordファイルをxmlファイルとして開く
“connections/binding”を探して、”value”から”fontValue”へ書き換える

これを

     destination="yT7-o4-ML5" name="value" keyPath="self.modelFont2" id="m1U-oD-u8W"/>

こうする

     destination="yT7-o4-ML5" name="fontValue" keyPath="self.modelFont2" id="m1U-oD-u8W"/>

“open as”で、.xibや.storybordファイルをIBファイルとして開く

そーすると、以下のようにGUIで設定できるようになってる。

NSViewControllerのサンプルコードその2

Tue, 11 Dec 2018 00:00:00 +0900

NSViewControllerのサンプルコードその2

Inspectorパネルも共有するコードは失敗した。 Cocoa bindingがうまく結合できない。

失敗したソースはこれ。( ViewControllerSikenjo2.zip )

成功していないので、成功したソースはない。

NSViewControllerのサンプルコードその1

Mon, 10 Dec 2018 00:00:00 +0900

NSViewControllerのサンプルコードその1

1つのViewControllerをsheet, dialog, popoverで共有する、サンプルコード。

ソースはこれ。( ViewControllerSikenjo1.zip )

内側に影が付いている ScrollView

Fri, 07 Dec 2018 00:00:00 +0900

内側に影が付いている ScrollView

タイトルそのまま。ScrollerViewに影を付ける事で、スクロールできる領域ですよと、控えめに主張するクラスを作った。

ソースはこれ。( ControlSikenjo2.zip )

サンプルコードの注意事項は、「真四角」と名前がつけられた画像ファイルには、「たてなが」と描かれています。

ややこしいですが、640x640の正方形の画像です。

バグではなくて仕様です。

長押しするPopupmenuのボタン

Tue, 04 Dec 2018 00:00:00 +0900

長押しするPopupmenuのボタン

タイトルそのまま。ActionPopupButton、長押しするPopupmenuのボタン。

ソースはこれ。( ControlSikenjo1.zip )

>> ソースへのリンクが切れているように思いますありがとう。リンク切れ直しました。

Responder chainの表示

Sat, 01 Dec 2018 00:00:00 +0900

Responder chainの表示

パレットに、first responder からの responder chain を表示する。デバッグ用。

サンプルコードでは、control-Rでパレットを表示すするようにしている。

カギカッコの中のアルファベットの意味は、”R”はNSResponder、”D”はdelegate、”O”はその他。

delegate, NSApplication, NSDocumentController, NSDocumentのresponder chainの中での位置づけは、NSResponderのサブクラスの物とは異なるので、別に処理している。

アップし直した。ソースはこれ。( BoxShadowExample2.zip )

Cocoaで Box Shadow

Mon, 26 Nov 2018 00:00:00 +0900

Cocoaで Box Shadow

ほんのりと、片側がめくれる感じで。

ソースはこれ。( BoxShadowExample.zip )

NSPasteboardの動作を調べるために小さなアプリを作ってみた(2)

Sun, 28 Oct 2018 00:00:00 +0900

NSPasteboardの動作を調べるために小さなアプリを作ってみた(2)

ソースはこれ。( pasteApp2.zip )

改良点は、NSPasteboardItemのtypeの中身を表示するように変更した。

NSPasteboardの動作を調べるために小さなアプリを作ってみた

Fri, 26 Oct 2018 00:00:00 +0900

NSPasteboardの動作を調べるために小さなアプリを作ってみた

結論

NSPasteboardItemを複数持つアプリは、自作アプリしか確認できなかった。

enumerateDraggingItemsWithOptionsはあまり使われていないのではないだろうか？
NSPasteboardItemに入るUTIには”dyn.xxx”のような不明なUTIも存在する。

おそらく、同一アプリ内でのCopy&Pasteする場合の判定用の一時的なUTIと思われる。
NSPasteboardItemに持たせるデータの種類は意外に多い

同じテキストでもutf8とutf16で別々に持たせていた。
Drag & Drop 中のデータのUTIが観れるのは楽しい。

macOS7時代では、Drag & Drop をサポートするのに苦労したから楽できるのは良い。

ソースはこれ。( pasteApp.zip )

TabUIの実験

Wed, 17 Oct 2018 00:00:00 +0900

TabUIの実験

こっち。( TabUI.zip )

ライフゲームその5 swiftで書き直した

Wed, 12 Sep 2018 00:00:00 +0900

ライフゲームその5 swiftで書き直した

すまん。こっちだ。( haifusiryou.zip )

ライフゲームその4 swiftで書き直した

Sun, 02 Sep 2018 00:00:00 +0900

ライフゲームその4 swiftで書き直した

Documentベースにして、NSMatrxiの使用をやめて、Swiftで書き直した。

ソースコードはここ。( ConwaysGameOfLife.zip )

NSMenuの中にNSViewを入れる

Thu, 16 Aug 2018 00:00:00 +0900

NSMenuの中にNSViewを入れる

ObjCの以下のコードを参考にしてSwiftで書いた。

https://developer.apple.com/library/archive/samplecode/MenuItemView/Introduction/Intro.html

ViewInMenu.zip

今回はやくにたつかも

落穂拾い 2018/08/10

Fri, 10 Aug 2018 00:00:00 +0900

落穂拾い 2018/08/10

News - Apple Developer

日本語字幕の追加はありがたいな。

スラド: アップル

VirtualBoxへのMojaveのインストール

Tue, 24 Jul 2018 00:00:00 +0900

VirtualBoxへのMojaveのインストール

概要

インストールする上での問題は2つある。

MojaveではUSB1.1コントローラはサポート対象外
Mojaveのインストーラは、インストール先のHDD/SSDをAPFSに変換するが、VirtualBoxのBIOSはAPFSフォーマットのHDD/SSDからの起動をサポートしていない。

このため、通常の方法では、VirtualBoxへMojaveをインストールすることは出来ない。

USB機器が使えない問題の解決方法は簡単。VirtualBoxのextraPackをインストールして、USB3.0コントローラを使用するようにするだけで解決できる。

APFSフォーマット問題の解決方法は簡単だが面倒。MojaveをインストールしたAPFSフォーマットのHDD/SSDから、別途用意したHFS+フォーマットのHDD/SSDへコピーする事で解決する。

インストール手順

準備

“Oracle_VM_VirtualBox_Extension_Pack”を入手してインストールする。

入手先は、http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html 。

Mojaveベータの入手は、Developer Programに入っていればダウンロード方法は分かるはずなので明記しない。

ダウンロード後に、VirtualBox用のmacOSインストールディスクを作るを参考にしてisoファイルを作る。

$ hdiutil create -o /tmp/Mojave -size 8G -layout SPUD -fs HFS+J -type SPARSE

$ hdiutil attach /tmp/Mojave.sparseimage -noverify -mountpoint /Volumes/install_build
/dev/disk3                  Apple_partition_scheme
/dev/disk3s1                Apple_partition_map
/dev/disk3s2                Apple_HFS                       /Volumes/install_build

$ sudo ./Install\ macOS\ Mojave\ Beta.app/Contents/Resources/createinstallmedia  --volume /Volumes/install_build

Password:
Ready to start.
To continue we need to erase the volume at /Volumes/install_build.
If you wish to continue type (Y) then press return: Y
Erasing disk: 0%... 10%... 20%... 30%... 100%
Copying to disk: 0%... 10%... 20%... 100%
Making disk bootable...
Copying boot files...
Install media now available at "/Volumes/Install macOS Mojave Beta"
$ hdiutil detach /Volumes/Install\ macOS\ Mojave\ Beta/
"disk3" unmounted.
"disk3" ejected.
$ hdiutil convert /tmp/Mojave.sparseimage -format UDTO -o /tmp/Mojave.iso
Driver Descriptor Map（DDM: 0）を読み込み中…
Apple（Apple_partition_map: 1）を読み込み中…
（Apple_Free: 2）を読み込み中…
disk image（Apple_HFS: 3）を読み込み中…
.............................................................................................................................
経過時間: 19.920s
速度: 411.2Mバイト/秒
節約率: 0.0%
created: /tmp/Mojave.iso.cdr
$ mv /tmp/Mojave.iso.cdr ~/Desktop/Mojave.iso
$ rm /tmp/Mojave.sparseimage

デスクトップに以下のようなアイコンが出来る。ファイル名は、”Mojave.iso”

VMの作成

VirtualBox上のmacOS用VMの作成を参考にしてVMを作成する。

設定する値は以下の通り。

名前	任意
タイプ	Mac OS X
バージョン	mac OS 10.13 Hight Sierra (64-bit)
メモリーサイズ	4096
ハードディスク	仮想ハードデスクを作成する
ファイルサイズ	50.00GB
ハードデスクのファイルタイプ	VDI
物理ハードディスクにあるストレージ	可変サイズ

上記の設定でVMを設定後、各種細かい設定を修正してゆく。

システム ‣ マザーボード ‣ 起動順序 ‣ フロッピーのチェックボックスを外す。

システム ‣ プロセッサー ‣ プロセッサー数の値を2に変更

システム ‣ プロセッサー ‣ 使用率制限の値を80%に変更

ディスプレイ ‣ スクリーン ‣ ビデオメモリーの値を128Mに変更

オーディオ ‣ オーディオを有効化のチェックボックスを外す。

ストレージ ‣ ストレージデバイス ‣ 内蔵ディスクを選ぶ(名前はそれぞれ) ‣ 属性 ‣ SSD のチェックボックスを外す。

ストレージ ‣ ストレージデバイス ‣ 光学デバイスを選ぶ(名前は空) ‣ 光学ドライブの右側の光学ドライブボタンを押す。そこは、ポップアップメニューになっている。”Mojave.iso”を選ぶ。

ストレージ ‣ ストレージデバイス ‣ 下のひし形にプラス記号のアイコンを選び、USBコントローラを追加する。

ストレージ ‣ ストレージデバイス ‣ コントローラ：USB ‣ HDDにプラス記号のアイコンを選び、仮想外付HDを作成する。

ポート ‣ USB ‣ USBコントローラを有効 ‣ USB 3.0 コントローラを選ぶ。

メディアの初期化

作成したVMを起動すると、Mojave.isoから起動される。

日本語を選ぶ。

仮想内蔵HDと仮想外付HDをHFS+にフォーマットするために、Disk Utilityを選ぶ。

ここで、Disk Utilityを選び、仮想内蔵HDと仮想外付HDをHFS+にフォーマットする。

仮想内蔵HDをHFS+にフォーマットする。

仮想外付HDをHFS+にフォーマットする。

Disk Utilityを終了し、最初の画面に戻り、MacOSインストールを選ぶ。

インストールの設定を開始する。

インストール先のHDは仮想外付HDの”External_HD”。アイコンが違うので名前が違っても間違わないはず。

インストール作業が続行される。

しばらくすると、コンソール画面のようになった後、再起動され再び、以下の画面になる。

インストール開始

VMを一度終了させる。

リンゴ ‣ システム終了を選ぶ。

再び、VMの設定を開き、光学デバイスのDVDをアンマウントする。

ここで、VMを起動する。起動できるメディアがないので以下のような画面になる。

“exit”と打ち込み”return”キーを押すと、以下のような画面へゆく。

VMへのmacOSのインストールの続きを参考にbootファイルを設定する。

Boot Maintenance Manager ‣ Boot From File ‣ PociRoot….HD(2,GPT,…)] を選ぶ。

‣ ‣ ‣ boot.efi] を選ぶ。

再び、コンソール画面のようにログが流れる。

落ち着いた頃に、以下の画面になる。

これで、仮想外付HDはAPFSにフォーマットされ、mojaveがインストールされる。この後、再起動されるがVirtualBoxはAPFSをサポートしないので、OSは起動しない。

そして再び、以下の画面になる。

ここで、またVMを終了(Power off)する。

ファイルのコピー

再びインストールメディアを使う。正確にはその中のターミナルを使う。

VMの設定で、ストレージ ‣ ストレージデバイス ‣ 光学デバイスを選ぶ(名前は空) ‣ 光学ドライブの右側の光学ドライブボタンを押す。そこは、ポップアップメニューになっている。”Mojave.iso”を選ぶ。

VMを起動。再び以下の画面になる。

ユーティリティ ‣ ターミナルを選ぶ。

以下のコマンドで外付HDから内蔵HDに全部コピーする。

cp -f -p -R /Volumes/外付HD名/ /Volumes/内蔵HD名

次に、以下のコマンドで、内蔵HDを起動可能にする

bless -folder /Volumes/内蔵HD名/System/Library/CoreServices

VMを終了させ、仮想DVDをアンマウントする。再び、VMを起動する。

アカウントの設定画面になるので、設定すると、以下のような画面になってインストールが完了する。

なお、仮想外付HDは不要なのでアンマウントして削除して良い。

Guest/HostもmacなVirtualBoxのストレージの拡張方法

Fri, 13 Jul 2018 00:00:00 +0900

Guest/HostもmacなVirtualBoxのストレージの拡張方法

コマンドラインを使ってVMのストレージ容量を拡張

まずは、VMのUUIDを調べる。

$ VBoxManage list hdds
    UUID:           1fee78f5-ae4a-4d74-8571-7ac918ff56cb
    Parent UUID:    base
    State:          created
    Type:           normal (base)
    Location:       ~/VirtualBox VMs/VmMac_13/VmMac01.vdi
    Storage format: VDI
    Capacity:       30720 MBytes
    Encryption:     disabled

対象とする、ストレージののUUIDがわかったら、対象のストレージのサイズを変更する

$ VBoxManage modifyhd 1fee78f5-ae4a-4d74-8571-7ac918ff56cb --resize 51200
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

こんな面倒な事をやらなくてもGUIで設定画面があった。

スライダーで容量を調整できる。

diskutilでパーティションの変更

マシンを再起動して、F12を押しまくり、BIOSに入る。

そこで、リカバリ用の boot file を選択してbootする。

Boot Maitenance Manger ‣ Boot From File ‣ HD(3,GPT….) ‣ ‣ boot.efi を選ぶ。

起動プロセスを継続して、しばらくすると、こんな画面になるので日本語を選ぶ。

この画面で、ユーティリティ ‣ ターミナルを選ぶ。

これで、ターミナルのコマンドが使える。が、コピペが使えないので、手打ち。

まず、デバイスの確認。

$ diskutil list

多分、表示が多すぎのはずなので、絞り込む。

$ diskutil list /dev/disk0

ここで、出てくる。”Apple_HFS Machintosh HD”のサイズを変更したい。この行の末尾にある文字列”disk0s2”を識別子として使う。

最大容量の確認をする。

$ diskutil resizeVolume /dev/disk0s2 limits

最大容量が表示されるので、その値を使う。ここでは”52G”

$ diskutil resizeVolume /dev/disk0s2 52G

なぜか、エラーが発生した。”diskutil repairDisk”を実効せいとの事。素直に従う。

$ diskutil repairDisk /dev/disk0

その後、再び、resizeVolumeを実行する。

$ diskutil resizeVolume /dev/disk0s2 52G

その後再起動をすると、VMの中のHDの容量が増えている。

参考にしたページはこれ

https://qiita.com/mashumashu/items/cd2d90e0a3a9477d45c6

https://www.virment.com/extend-virtualbox-disk/

http://d.hatena.ne.jp/ikeas/20100219/1266602383

VirtualBoxでのmacOS10.13.5から10.13.6へのアップデート

Thu, 12 Jul 2018 00:00:00 +0900

VirtualBoxでのmacOS10.13.5から10.13.6へのアップデート

MacAppStoreからアップデートのお知らせが来たので、アップデート。

何も考えずに行うと、アップデートできない。

VirtualBoxがboot用のファイルの指定に失敗しているようだ。

macOS10.13のインストールの時のように手動で指定する必要がある。

macOS 10.13.6アップデータのダウンロード

ダウンロード後に、”再起動しない”を選ぶ。

スクリーンショットは撮り忘れた。

その後手動で、再起動する。

VMのBIOSか何かの設定を変える

起動直後に”F12”をおす。

失敗すると、以前のmacOSのバージョンが立ち上がり、アップデータのデータは削除される模様。再び、アップデータのダウンロードから始まる。

こんな画面になる。

boot file を指定する。

boot fileは、”/macOS Install Data/Locked Files/Boot Files/boot.efi” にある

パーティションは、”2,GPT….”を選ぶ。”3,GPT…”はリストア用のboot fileが入っているので間違わないこと。

ディレクトリを1個づつ下ってゆく。

ブートプロセスが再開されたら、画面を眺めてゆけばOK。

失敗した場合

こんな画面が出た時は、アップデータのダウンロードからやり直し。

参考にしたページはこれ

https://tobiwashere.de/2017/10/virtualbox-how-to-create-a-macos-high-sierra-vm-to-run-on-a-mac-host-system/

https://raimue.blog/2017/06/09/upgrading-a-vm-from-macos-10-12-sierra-to-macos-10-13-high-sierra-in-virtualbox/

VMへのmacOSのインストールの続き

Fri, 06 Jul 2018 00:00:00 +0900

VMへのmacOSのインストールの続き

無限ループ状態から脱出するために、BIOSの設定を変える。

VMのBIOSか何かの設定を変える

BIOSの設定画面を出すには、VMの起動直後に”F12”を押し続ける必要がある。

こんな画面になる。

“Boot Maintenance Manager”を選択する。

“Boot From File”を選択する。

“HD(2,GPT)…”を選択する。

“”を選択する。

“boot.efi”を選択する。

すると、以下のようなログが流れる画面になる。

macOSの最初の設定

しばらくすると、以下のような画面でプログレス表示になる。

ここら辺で、途中で光学デバイスを強制Ejectした気がする。が、関係あるかは不明。以前成功した時は、光学デバイスの起動順序を下げていた。が、今回はEjectで行った。

日本を選ぶ。

各種アカウントの設定を行うと、以下の画面になりインストール完了。

参考にしたページはこれ

https://tobiwashere.de/2017/10/virtualbox-how-to-create-a-macos-high-sierra-vm-to-run-on-a-mac-host-system/

VMの内蔵HDのフォーマットとmacOSのインストールの開始

Fri, 06 Jul 2018 00:00:00 +0900

VMの内蔵HDのフォーマットとmacOSのインストールの開始

VMの内蔵HDはmac用にフォーマットしないと使えない。

フォーマットしたのちに、インストールを行う。

ただし、macOSのインストールは、内蔵HDから起動できないので、途中から前に進まず最初の画面へ戻ってしまう。

VMの内蔵HDのフォーマット

VMを起動すると、コンソール画面にたくさん文字が表示される。

しばらく待つと、以下のような画面になる。

言語は日本語を選択する。

まずは、内蔵HDのフォーマットをするために、ディスクユーティリティーを立ち上げる。

“VBOX HARDDISK Media”を選択して、”消去”ボタンをおす

名前は適当に”Macintosh HD”でいいと思う。

名前	Macintosh HD
フォーマット	Mac OS拡張(ジャーナリング)
方式	GUIDパーティションマップ

消去を実行するとすぐに終わって、以下のような画面になる。

macOSのインストール

macOSのインストールは、途中で小細工をしないと最初の画面からの無限ループにハマる。

最初の1週目を行い。小細工をする前まで書いてゆく。

ディスクユーティリティーの終了後にインストーラを立ち上げる。

普通のインストーラの画面で続けてゆく

続けてゆく。

ハードディスクを選んで続けてゆく

プログレスバーが続いてゆく。

プログレスバーの進行が終わると、VMが再起動され、こんなコンソール画面風になる。

再び、光学ディスクから起動される。

最初の画面に戻る。

プログレスバーの進行が終わった後に、内蔵ハードディスクから起動して欲しいのだが、起動されない。

小細工を追加すると内蔵ハードディスクで起動されるようになる。

参考にしたページはこれ

https://tobiwashere.de/2017/10/virtualbox-how-to-create-a-macos-high-sierra-vm-to-run-on-a-mac-host-system/

VirtualBox上のmacOS用VMの作成

Thu, 05 Jul 2018 00:00:00 +0900

VirtualBox上のmacOS用VMの作成

macOSをインストールするためのVMの作成。以下の設定で作成する。

VMの作成

新規ボタンを押せばOK。あとは、指示に従い、以下の設定を行えば問題ない。

名前	任意
タイプ	Mac OS X
バージョン	mac OS 10.13 Hight Sierra (64-bit)
メモリーサイズ	4096
ハードディスク	仮想ハードデスクを作成する

ファイルサイズ	30.00GB
ハードデスクのファイルタイプ	VDI
物理ハードディスクにあるストレージ	可変サイズ

作成したVMの設定の調整

設定ボタンを押すと、設定ウインドウが表示される。

設定ウインドウの以下の値を設定してゆく

システム ‣ マザーボード ‣ 起動順序 ‣ フロッピーのチェックボックスを外す。

システム ‣ プロセッサー ‣ プロセッサー数の値を2に変更

システム ‣ プロセッサー ‣ 使用率制限の値を80%に変更

ディスプレイ ‣ スクリーン ‣ ビデオメモリーの値を80%に変更

ストレージ ‣ ストレージデバイス ‣ 内蔵ディスクを選ぶ(名前はそれぞれ) ‣ 属性 ‣ SSD のチェックボックスを外す。

ストレージ ‣ ストレージデバイス ‣ 光学デバイスを選ぶ(名前は空) ‣ 光学ドライブの右側の光学ドライブボタンを押す。そこは、ポップアップメニューになっている。”HighSierra.iso”を選ぶ。

オーディオ ‣ オーディオを有効化のチェックボックスを外す。

参考にしたページはこれ

https://tobiwashere.de/2017/10/virtualbox-how-to-create-a-macos-high-sierra-vm-to-run-on-a-mac-host-system/

VirtualBox用のmacOSインストールディスクを作る

Thu, 05 Jul 2018 00:00:00 +0900

VirtualBox用のmacOSインストールディスクを作る

元データの入手

macOS High Sierraは、Mac App Storeから入手できる。ダウンロードはここ

このアプリケーションの中に、インストールディスクを作るためのリソースが全て入っている。

.
└── Contents
    ├── Frameworks
    ├── Info.plist
    ├── MacOS
    ├── PkgInfo
    ├── PlugIns
    ├── Resources
    ├── SharedSupport
    │   ├── AppleDiagnostics.chunklist
    │   ├── AppleDiagnostics.dmg
    │   ├── BaseSystem.chunklist
    │   ├── BaseSystem.dmg
    │   ├── InstallESD.dmg
    │   └── InstallInfo.plist
    ├── _CodeSignature
    └── version.plist

isoデータの作成

ダウンロードしたインストーラから、以下のコマンドでDesktopにisoファイルを作れる。

$ hdiutil create -o /tmp/HighSierra -size 8G -layout SPUD -fs HFS+J -type SPARSE
created: /tmp/HighSierra.sparseimage
$ hdiutil attach /tmp/HighSierra.sparseimage -noverify -mountpoint /Volumes/install_build
/dev/disk9                  Apple_partition_scheme
/dev/disk9s1                Apple_partition_map
/dev/disk9s2                Apple_HFS                       /Volumes/install_build
$ sudo /Applications/Install\ macOS\ High\ Sierra.app/Contents/Resources/createinstallmedia --volume /Volumes/install_build
Password:
Ready to start.
To continue we need to erase the volume at /Volumes/install_build.
If you wish to continue type (Y) then press return: Y
Erasing Disk: 0%... 10%... 20%... 30%...100%...
Copying installer files to disk...
Copy complete.
Making disk bootable...
Copying boot files...
Copy complete.
Done.
$ hdiutil detach /Volumes/Install\ macOS\ High\ Sierra/
"disk9" unmounted.
"disk9" ejected.
$ hdiutil convert /tmp/HighSierra.sparseimage -format UDTO -o /tmp/HighSierra.iso
Driver Descriptor Map（DDM: 0）を読み込み中…
Apple（Apple_partition_map: 1）を読み込み中…
（Apple_Free: 2）を読み込み中…
disk image（Apple_HFS: 3）を読み込み中…
..........................................................................................................................................
経過時間: 17.273s
速度: 474.3Mバイト/秒
節約率: 0.0%
created: /tmp/HighSierra.iso.cdr
$ mv /tmp/HighSierra.iso.cdr ~/Desktop/HighSierra.iso
$ rm /tmp/HighSierra.sparseimage

デスクトップに以下のようなアイコンが出来る。ファイル名は、”HighSierra.iso”

参考にしたページはこれ

https://tobiwashere.de/2017/10/virtualbox-how-to-create-a-macos-high-sierra-vm-to-run-on-a-mac-host-system/

落穂拾い 2018/07/05

Thu, 05 Jul 2018 00:00:00 +0900

落穂拾い 2018/07/05

Apple Developer Center

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ
AppKit Release Notes for macOS 10.14 beta

AppKitのリリースノートはLibraryの方に記載してほしい。

News - Apple Developer

Introducing App Store Connect

スラド: アップル

The Bash in Tokyo 発表資料

Thu, 14 Jun 2018 00:00:00 +0900

The Bash in Tokyo 発表資料

なぜか、渋谷で行う、BUKURO.swiftの発表資料です。

Cocoaの「逐次検索」を支援するクラスNSTextFinderについての発表をします。

以下のリンクから、資料をダウンロードしてください。

TableViewFinder2.zip

元々は関東swift勉強会2017-11の資料です。 NSTextFinderの使い方サンプルコードをコンパイルエラーが出ないように修正してます。

落穂拾い 2018/06/06

Wed, 06 Jun 2018 00:00:00 +0900

落穂拾い 2018/06/06

日本語ドキュメント - Apple Developer

Apple Developer Center

News - Apple Developer

スラド: アップル

落穂拾い 2018/05/23

Wed, 23 May 2018 00:00:00 +0900

落穂拾い 2018/05/23

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
Campaign Management API for News Publishers (iAd System JS|iAd Producer|iOS) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS|Xcode Developer Tools) マイナーチェンジ

サンプルコード

Breadcrumb: Using CoreLocation to track user movement (iOS) マイナーチェンジ
CloudKit Share: Building CloudKit local cache and using CloudKit share APIs (iOS) マイナーチェンジ
NEHotspotConfiguration Sample (iOS) 初版
TCPTransports: Using Various Apple APIs to Run a TCP Connection (iOS) 初版

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ

スラド: アップル

SpotlightとQuickLookをSwiftで作る

Fri, 11 May 2018 00:00:00 +0900

SpotlightとQuickLookをSwiftで作る

関東swift勉強会2018-05の資料です。

感想

今回はやくにたつかも

https://cocoa-kanto.connpass.com/event/85331/

QuickLookAndSpotlight.zip

落穂拾い 2018/05/08

Tue, 08 May 2018 00:00:00 +0900

落穂拾い 2018/05/08

Apple Developer Center

ガイド

Cryptographic Services Guide (tvOS|iOS|macOS) マイナーチェンジ
Playground Book Format Reference (Xcode Developer Tools) マイナーチェンジ

サンプルコード

DatePicker: Using NSDatePicker control to display date and time (macOS) アップデート
Earthquakes: Populating a Core Data Store Using a Background Queue (iOS|macOS) アップデート
ImageBrowser: Using IKImageBrowserView to display images (macOS) マイナーチェンジ
ImageBrowserViewAppearance: Customizing IKImageBrowserView (macOS) アップデート
StarterPlaygroundBook: A simple Swift Playground Book (Xcode Developer Tools) 初版
ToolbarSample: Using NSToolbar to construct a window toolbar (macOS) アップデート
Unit Testing Apps and Frameworks (iOS|macOS) アップデート

News - Apple Developer

スラド: アップル

落穂拾い 2018/04/25

Wed, 25 Apr 2018 00:00:00 +0900

落穂拾い 2018/04/25

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS|Xcode Developer Tools) マイナーチェンジ

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ

News - Apple Developer

64-bit Transition on macOS

スラド: アップル

落穂拾い 2018/04/11

Wed, 11 Apr 2018 00:00:00 +0900

落穂拾い 2018/04/11

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
Apple TV Markup Language Reference (tvOS) アップデート
Asset Catalog Format Reference (watchOS|tvOS|iOS|Xcode Developer Tools|macOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) マイナーチェンジ
Final Cut Pro X XML Format (macOS) アップデート
HLS Authoring Specification for Apple Devices (tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) マイナーチェンジ
Notification Programming Guide for Websites (Safari|macOS) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS|Xcode Developer Tools) マイナーチェンジ
The Swift Programming Language (Swift 4.1) (Xcode Developer Tools) マイナーチェンジ
Using Swift with Cocoa and Objective-C (Swift 4.1) (Xcode Developer Tools) マイナーチェンジ

サンプルコード

Audio in ARKit (iOS) マイナーチェンジ
Fox 2: SceneKit WWDC 2017 sample code (tvOS|iOS|macOS) マイナーチェンジ
Table Search with UISearchController (iOS) マイナーチェンジ

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ
iOS 11.3 SDK Release Notes (iOS) 初版
macOS 10.13.4 SDK Release Notes (macOS) 初版
tvOS 11.3 SDK Release Notes (tvOS) 初版
watchOS 4.3 SDK Release Notes (watchOS) 初版

News - Apple Developer

スラド: アップル

tinker運用ノート(4)

Sat, 07 Apr 2018 00:00:00 +0900

tinker運用ノート(4)

macPortsのupdateでtinkerが動かなくなった。

原因は、以下の2つ。

macPortsで入れるsphinxのバージョンが1.7x系になっていた。

一方、tinkerは、sphinxのバージョンは1.6系で動く。

今までは、macPortsでupdateの時に気をつけて、sphinxのアップデートをしないようにしていた。しかし、先日、誤ってupdateした上に、古いバージョンを消去してしまった。

この機会にと思い、Pythonのパッケージシステムの仮想環境を試してみた。

環境の構築

Tinkerの1.7のを使うと、Sphinxのバージョンを下げて仮想環境にインストールしてくれる。

$ # 適当なディレクトリに仮想のパッケージシステム環境を作る
$ python3 -m venv ./tinkerer_env
$ source ./tinkerer_env/bin/activate
$ # Tinker 1.7をインストール
$ pip install git+https://github.com/vladris/tinkerer.git@master --
$ # バージョンの確認
$ tinker --version
Tinkerer version 1.7.0
$ # さらに各種extensionもインストール
$ pip install sphinxcontrib-actdiag sphinxcontrib-blockdiag sphinxcontrib-nwdiag sphinxcontrib-seqdiag sphinxcontrib-tikz

ターミナルで設定済みの仮想のパッケージシステム環境を使うには

$ # 仮想環境のactivate
$ source ./tinkerer_env/bin/activate
$ # 確認( Tinkerer version 1.7.0 )と出てくるはず
$ tinker --version
Tinkerer version 1.7.0

あとは普段の通りに、Tinkererを使う。

参考文献

https://docs.python.jp/3/library/venv.html

https://github.com/vladris/tinkerer/issues/108

http://imagawa.hatenadiary.jp/entry/2015/01/31/190000

矩形の移動

Wed, 04 Apr 2018 00:00:00 +0900

矩形の移動

関東swift勉強会2018-04の資料です。CGRectのextensionを作る。

感想

今回はやくにたつかも

https://cocoa-kanto.connpass.com/event/80016/

GeometrySikenjo.zip

落穂拾い 2018/03/19

Mon, 19 Mar 2018 00:00:00 +0900

落穂拾い 2018/03/19

日本語ドキュメントのRSSがまだ取れない。”https://developer.apple.com/jp/rss/adcjapan.rss”

諦めるか。

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
Apple Music API Reference (tvOS|iOS|macOS) アップデート
Apple News API Reference (iOS) マイナーチェンジ
Apple News Format Reference (iOS) マイナーチェンジ
Asset Catalog Format Reference (watchOS|tvOS|iOS|Xcode Developer Tools|macOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) マイナーチェンジ
File System Programming Guide (watchOS|tvOS|iOS|macOS) マイナーチェンジ
HLS Authoring Specification for Apple Devices (tvOS|iOS|macOS) マイナーチェンジ
In-App Purchase Programming Guide (tvOS|iOS|macOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Media Playback Programming Guide (tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) マイナーチェンジ
Over-the-Air Profile Delivery and Configuration (iOS) マイナーチェンジ
Playground Book Format Reference (Xcode Developer Tools) マイナーチェンジ
Safari Content-Blocking Rules Reference (Safari (Mobile)|Safari|iOS|macOS) マイナーチェンジ
Safari Extensions Development Guide (Safari|macOS) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS|Xcode Developer Tools) マイナーチェンジ
Text Programming Guide for iOS (tvOS|iOS) マイナーチェンジ
The Swift Programming Language (Swift 4.1) (Xcode Developer Tools) マイナーチェンジ
Using Swift with Cocoa and Objective-C (Swift 4.1) (Xcode Developer Tools) マイナーチェンジ
Wallet Developer Guide (watchOS|iOS) マイナーチェンジ
WebDriver Commands for Safari (Safari|macOS) マイナーチェンジ

サンプルコード

AVFoundationPiPPlayer: Picture-in-Picture Playback with AVKit (iOS) マイナーチェンジ
Audio in ARKit (iOS) マイナーチェンジ
CoreBluetooth: Health Thermometer (macOS) マイナーチェンジ
CoreBluetooth: Heart Rate Monitor (macOS) マイナーチェンジ
Fox 2: SceneKit WWDC 2017 sample code (tvOS|iOS|macOS) マイナーチェンジ
Interactive Content with ARKit (iOS) マイナーチェンジ
SourceView: Using NSOutlineView with NSTreeController (macOS) アップデート
Table Search with UISearchController (iOS) マイナーチェンジ
Tabster: Various techniques in using UITabBarController (iOS) アップデート
UnwindSegue (iOS) マイナーチェンジ

リリースノート

What’s New in Safari (watchOS|tvOS|Safari (Mobile)|Safari|iOS|macOS) アップデート

News - Apple Developer

日本語ドキュメント - Apple Developer

スラド: アップル

NSDcoument複数ファイルフォーマットその2

Thu, 15 Feb 2018 00:00:00 +0900

NSDcoument複数ファイルフォーマットその2

関東swift勉強会2018-02の資料です。今回もNSDcoumentで複数のファイルフォーマットをサポートするコード周りの解説です。

感想

今回も、多分、誰の役にも立たない。

https://cocoa-kanto.connpass.com/event/75430/

NSDocument-fileFormat2.zip

落穂拾い 2018/01/14

Sun, 14 Jan 2018 00:00:00 +0900

落穂拾い 2018/01/14

日本語ドキュメントのRSSが取れなくなった。”https://developer.apple.com/jp/rss/adcjapan.rss”

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
Apple News Format Reference (iOS) マイナーチェンジ
Business Chat Specifications (iOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) マイナーチェンジ
Final Cut Pro X XML Format (macOS) アップデート
HLS Authoring Specification for Apple Devices (tvOS|iOS|macOS) マイナーチェンジ
Media Playback Programming Guide (tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) マイナーチェンジ
PassKit Package Format Reference (watchOS|iOS) マイナーチェンジ
Receipt Validation Programming Guide (tvOS|iOS|macOS) アップデート
Search Ads API Reference (iAd System JS|iAd Producer|iOS|Xcode Developer Tools) マイナーチェンジ
Simulator Help Topics (Xcode Developer Tools) 初版
The Swift Programming Language (Swift 4.0.3) (Xcode Developer Tools) マイナーチェンジ
Using Swift with Cocoa and Objective-C (Swift 4.0.3) (Xcode Developer Tools) マイナーチェンジ

サンプルコード

ApplicationShortcuts: Using UIApplicationShortcutItems (iOS) マイナーチェンジ
ButtonMadness: Creating and Customizing AppKit Controls (macOS) アップデート
Checking and Requesting Access to Data Classes in Privacy Settings (iOS) アップデート
DateSectionTitles: Custom Table Sections with NSFetchedResultsController (iOS) アップデート
LazyTableImages: Populating UITableView content asynchronously (iOS) アップデート
MapSearch (iOS) マイナーチェンジ
NavBar: Customizing UINavigationBar’s appearance (iOS) アップデート
PhotoPicker: Using UIImagePickerController to Select Pictures and Take Photos (iOS) マイナーチェンジ
Table Search with UISearchController (iOS) マイナーチェンジ
TouchCanvas: Using UITouch efficiently and effectively (iOS) マイナーチェンジ
UIKit Catalog (iOS): Creating and Customizing UIKit Controls (iOS) アップデート

テクニカルノートとQA

Debugging FairPlay Streaming (tvOS|Safari|iOS|macOS) アップデート
Rendering the currently visible frame of a paused AVPlayer that has a custom video compositor (iOS) 初版
Understanding and Analyzing Application Crash Reports (Xcode Developer Tools) マイナーチェンジ
Understanding the EXT-X-VERSION tag (tvOS|Safari|iOS|macOS) マイナーチェンジ

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ
iOS 11.2 SDK Release Notes (iOS) 初版
macOS 10.13.2 SDK Release Notes (macOS) 初版
tvOS 11.2 SDK Release Notes (tvOS) 初版
watchOS 4.2 SDK Release Notes (watchOS) 初版

News - Apple Developer

日本語ドキュメント - Apple Developer

スラド: アップル

NSDcoument複数ファイルフォーマット

Sun, 31 Dec 2017 00:00:00 +0900

NSDcoument複数ファイルフォーマット

関東swift勉強会2018-01の資料です。NSDcoumentで複数のファイルフォーマットをサポートするコード周りの解説です。

感想

今回も、多分、誰の役にも立たない。

https://cocoa-kanto.connpass.com/event/75006/

NSDocument-fileFormat.zip

NSTextFinderの使い方

Sun, 19 Nov 2017 00:00:00 +0900

NSTextFinderの使い方

以下の2つの資料を纏めて、サンプルコードを実装した。

Appleのリファレンス

https://developer.apple.com/documentation/appkit/nstextfinder

NSTextFinder Magic

https://blog.timschroeder.net/2012/01/12/nstextfinder-magic/

サンプルコードと感想

今回も、多分、誰の役にも立たない。

関東swift勉強会2017-11の資料です。 https://cocoa-kanto.connpass.com/event/70765/

TableViewFinder.zip

落穂拾い 2017/11/11

Sat, 11 Nov 2017 00:00:00 +0900

落穂拾い 2017/11/11

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS|macOS) マイナーチェンジ
App Extension Programming Guide (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Apple News API Reference (iOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) マイナーチェンジ
Core Audio Overview (iOS|macOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) マイナーチェンジ
PassKit Package Format Reference (watchOS|iOS) マイナーチェンジ
Text Programming Guide for iOS (tvOS|iOS) マイナーチェンジ
Wallet Developer Guide (watchOS|iOS) マイナーチェンジ
iOS Device Compatibility Reference (iOS) マイナーチェンジ

サンプルコード

HLS Catalog: Using AVFoundation to play and persist HTTP Live Streams (iOS) アップデート
PDF Annotation Editor (macOS) 初版
QuickLookDownloader (macOS) マイナーチェンジ
Speakerbox: Using CallKit to create a VoIP app (iOS) 初版
Using the Watch Connectivity API (watchOS|iOS) 初版

テクニカルノートとQA

Cannot load underlying module for XCTest (iOS|Xcode Developer Tools|macOS) 初版
HTTPS and Test Servers (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Hey Siri, How Can I Improve the Recognition of My App’s Name? (iOS) マイナーチェンジ
Installation Failure Troubleshooting for iOS (iOS) マイナーチェンジ
Responding to screen capture in iOS 11. (iOS) 初版
Updating Your Apps To Support 64-bit in iOS 11 (iOS) 初版

リリースノート

Xcode Release Notes (Xcode Developer Tools) 初版
iOS 11.1 SDK Release Notes (iOS) 初版
macOS 10.13.1 SDK Release Notes (macOS) 初版
tvOS 11.1 SDK Release Notes (tvOS) 初版
watchOS 4.1 SDK Release Notes (watchOS) 初版

News - Apple Developer

スラド: アップル

Cocoaからのライブ変換(LiveConversion)の変更と監視その2

Wed, 01 Nov 2017 00:00:00 +0900

Cocoaからのライブ変換(LiveConversion)の変更と監視その2

進捗があった。非公開プロトコルを適応することで、ライブ変換を制御できる。

変更と監視は出来ない。TextFieldに入力中にライブ変換を一時的に無効にすることができるだけ。

プロトコルNSTextInputClient_IncrementalSearch

NTextViewのサブクラスで、NSTextInputClient_IncrementalSearchに適合しているクラスではライブ変換は無効になる。

ヘッダは以下のようになっている。

@class NSEvent;

@protocol NSTextInputClient_IncrementalSearch
- (BOOL)wouldHandleEvent:(NSEvent *)arg1;
- (unsigned long long)incrementalSearchClientGeometry;
@end

メソッドそれぞれの詳細は不明だが、wouldHandleEventではfalseを返し、incrementalSearchClientGeometryでは0を返すことで動作した。

incrementalSearchClientGeometryで0以外の場合は、変換候補のWindowが表示されなかった。

field editor

NSWindow上にNSTextFieldを複数配置した場合を考えます。この時、Textの編集が出来るNSTextFieldは常に、その内のどれか一つです。その他のNSTextFieldは、表示されているだけです。

この特徴を特性を利用して、Cocoaフレームワークでは、NSTextFieldは表示だけを行い、編集するときは同じ場所で別のオブジェクト(NSTextView)に任せるという方式を採用しています。

この別のオブジェクトは、NSWindow上のNSTextFieldで共有されており、それをField Editorと呼びます。

昔々のNextStepの時代では、CPUのパワーは今よりも貴重でした。Cocoaフレームワークには、その時代の設計の名残があります。field editorもその名残です。

このことは、先ほどのライブ変換を制御と関係があります。ライブ変換を制御するには、NSTextFieldのサブクラスだけではなくて、NSTextInputClient_IncrementalSearchに適応したNSTextViewのサブクラスを作る必要があるのです。

さらには、上記の text field を挿げ替えて、特定のTextFieldの時だけ、こちらが指定した custom field editor を使用するように指示する必要があります。

この仕組みは、以下のようになります。

class WindowController: NSWindowController, NSWindowDelegate
{
        .
        .
        .
    @objc dynamic var custumFieldEditor: MINTLIncrementalSearchFieldEditor? = nil

    public func windowWillReturnFieldEditor(_ sender: NSWindow, to client: Any?) -> Any?
    {
        // カスタムのfieldEditorを使う
        if client is MINTLIncrementalSearchField?
        {
            if self.custumFieldEditor == nil
            {
                self.custumFieldEditor = MINTLIncrementalSearchFieldEditor()
                self.custumFieldEditor!.isFieldEditor = true
            }

            return self.custumFieldEditor
        }

        // デフォルトのfieldEditorを使う
        return nil
    }
        .
        .
        .
}

サンプルコードと感想

多分、誰の役にも立たない。

BUKURO.swift 2017-11の資料です。 https://cocoa-kanto.connpass.com/event/68404/

IncrementalSearchField.zip

Outliner 巻き上げUI

Fri, 20 Oct 2017 00:00:00 +0900

Outliner 巻き上げUI

関東swift勉強会2017-10の資料です。

巻き上げUIの実装

落穂拾い 2017/09/24

Sun, 24 Sep 2017 00:00:00 +0900

落穂拾い 2017/09/24

Apple Developer Center

ガイド

Apple Music API Reference (tvOS|iOS|macOS) 初版
Apple News Format Reference (iOS) マイナーチェンジ
Apple News Format: Advanced Design Tutorial (iOS) マイナーチェンジ
Apple News Format: Design Tutorial (iOS) マイナーチェンジ
Apple TV Markup Language Reference (tvOS) アップデート
Apple URL Scheme Reference (watchOS|Safari (Mobile)|Safari|iOS|macOS) マイナーチェンジ
Asset Catalog Format Reference (watchOS|tvOS|iOS|Xcode Developer Tools|macOS) マイナーチェンジ
Audio Session Programming Guide (watchOS|tvOS|iOS) アップデート
Business Chat Specifications (iOS) アップデート
Campaign Management API for News Publishers (iAd System JS|iAd Producer|iOS) マイナーチェンジ
CloudKit Quick Start (Xcode Developer Tools) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) アップデート
Debugging with Xcode (Xcode Developer Tools) マイナーチェンジ
HLS Authoring Specification for Apple Devices (tvOS|iOS|macOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) アップデート
Over-the-Air Profile Delivery and Configuration (iOS) マイナーチェンジ
Payment Token Format Reference (iOS) マイナーチェンジ
Playground Book Format Reference (Xcode Developer Tools) マイナーチェンジ
TVML Programming Guide (tvOS) アップデート
The Swift Programming Language (Swift 4) (Xcode Developer Tools) アップデート
Using Swift with Cocoa and Objective-C (Swift 4) (Xcode Developer Tools) アップデート
WebKit DOM Programming Topics (Safari (Mobile)|Safari|iOS|macOS) マイナーチェンジ
iOS Device Compatibility Reference (iOS) アップデート
iTunes Search API (iOS|macOS) 初版

サンプルコード

AVCamBarcode: Using AVFoundation to Detect Barcodes and Faces (iOS) アップデート
AVCamPhotoFilter: Using AVFoundation to Capture photos with image processing (iOS) アップデート
AccessibilityUIExamples (macOS) アップデート
AlignmentGuides: AppKit Haptic Feedback Filtering using NSAlignmentFeedbackFilter (macOS) マイナーチェンジ
Audio in ARKit (iOS) マイナーチェンジ
Interactive Content with ARKit (iOS) マイナーチェンジ
NSTouchBar Catalog: Creating and Customizing NSTouchBar (macOS) マイナーチェンジ
OpenCL Parallel Prefix Sum (aka Scan) Example (macOS) マイナーチェンジ
PageControl: Using a Paginated UIScrollView (iOS) アップデート
Quartz2D for iOS (iOS) アップデート
Unit Testing Apps and Frameworks (iOS|macOS) アップデート

テクニカルノートとQA

リリースノート

AppleScript Release Notes (macOS) アップデート
What’s New in macOS (macOS) マイナーチェンジ
What’s New in watchOS (watchOS) アップデート
What’s New in Xcode (Xcode Developer Tools) マイナーチェンジ
Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ
iOS 11 Release Notes (iOS) 初版
macOS 10.13 High Sierra Release Notes (macOS) 初版
tvOS Release Notes (tvOS) 初版
watchOS 4 Release Notes (watchOS) 初版

News and Updates - Apple Developer

日本語ドキュメント - Apple Developer

日本語訳更新
Audio Session プログラミングガイド
In App Purchase プログラミングガイド <https://developer.apple.com/jp/documentation/NetworkingInternet/Conceptual/StoreKitGuide/Introduction.html>`_
レシート検証プログラミングガイド <https://developer.apple.com/jp/documentation/General/ValidateAppStoreReceipt/Introduction.html>`_

スラド: アップル

9月23日の関東Swift勉強会の資料

Tue, 19 Sep 2017 00:00:00 +0900

9月23日の関東Swift勉強会の資料

9月23日の関東Swift勉強会の資料。「メニューのショートカット表記の変更」。

資料色々

9月4日のcocoa:Bukuro.swiftの資料

Sun, 03 Sep 2017 00:00:00 +0900

9月4日のcocoa:Bukuro.swiftの資料

Objective-Cで書いていたライブラリをSwiftへ移植中に得られた知見など色々。

資料色々

落穂拾い 2017/08/24

Thu, 24 Aug 2017 00:00:00 +0900

落穂拾い 2017/08/24

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS) マイナーチェンジ
Apple News API Reference (iOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) アップデート
In-App Purchase Programming Guide (tvOS|iOS|macOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) アップデート
Payment Token Format Reference (iOS) マイナーチェンジ
The Swift Programming Language (Swift 4) (Xcode Developer Tools) アップデート
Using Swift with Cocoa and Objective-C (Swift 4) (Xcode Developer Tools) アップデート

サンプルコード

AVCustomEdit (iOS) アップデート
CircleView (macOS) アップデート
DotView (macOS) アップデート
DotViewUndo (macOS) アップデート
Fox 2: SceneKit WWDC 2017 sample code (tvOS|iOS|macOS) マイナーチェンジ
Interactive Content with ARKit (iOS) 初版
LightTable (macOS) アップデート
MPSMatrixMultiplication: Creating and Multiplying Matrices in Metal (iOS) アップデート
OpenCL Parallel Prefix Sum (aka Scan) Example (macOS) マイナーチェンジ

テクニカルノートとQA

Remapping Keys in macOS 10.12 Sierra (macOS) マイナーチェンジ
Secure Kernel Extension Loading (macOS) マイナーチェンジ
iOS Wi-Fi Management APIs (iOS) マイナーチェンジ

スラド: アップル

落穂拾い 2017/08/01

Tue, 01 Aug 2017 00:00:00 +0900

落穂拾い 2017/08/01

Apple Developer Center

ガイド

Apple Music API Reference (tvOS|iOS|macOS) 初版
Business Chat Specifications (iOS) マイナーチェンジ
Configuration Profile Reference (tvOS|iOS|macOS) アップデート
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) アップデート
Search Ads API Reference (iAd System JS|iAd Producer|iOS) マイナーチェンジ

サンプルコード

Unit Testing Apps and Frameworks (iOS|macOS) アップデート
iPhoneCoreDataRecipes (iOS) アップデート

テクニカルノートとQA

How many calls can I make to the Speech Framework API? (iOS) 初版
Making the app name on a device consistent with the name in iTunes Connect. (iOS) アップデート

リリースノート

AppleScript Release Notes (macOS) アップデート

News and Updates - Apple Developer

PlaygroundでStoryboardの試作

Tue, 18 Jul 2017 00:00:00 +0900

PlaygroundでStoryboardの試作

Swiftでロジックを組み立てるのにPlaygroundは便利だが、UIに関してはいまいち使いにくかった。

色々と調べたら、UIに関しても、Playgroundでプレビューするする方法が分かった。

要約すると以下のようになる。

playground側でフレームワークを “import” すると、そのフレームワークが使える
テストしたいクラスやリソースを含めたフレームワークを作る
アプリケーションのソースコード中でplaygorundeで実行したいものは片っ端から、上記のフレームワークに入れる。
フレームワークをビルドしてから、playgroudで使えるようになる
上記の、アプリのプリジェクト、フレームワークのプロジェクト、プレイグラウンドをまとめるために、ワークスペースを作り、上記の3つをその中に入れる。
バンドルの指定が、メインバンドルでないことを気をつければふつーに使える。

準備

Playgroundとアプリケーションプロジェクトではお互いにソースファイルの共有がうまくゆかない。

シンボリックリンクやエリアスなども試したが、Xcodeの誤作動が多かった。

その上、Playgroundのリソースフォルダの中ではxibのコンパイルも自動ではやってくれない。

結局、以下のように間にフレームワークプロジェクトを挟む方法が最も簡単だった。

ワークスペースの作成

file > New… > Workspace… で、ワークスペースの作成。

アプリケーションプロジェクトの作成

先ほどのワークスペースのWindowの左下の”+”マークから、”New Project…”を選んで、アプリケーションプロジェクトの作成と追加。

この時、プロジェクトの種類はCocoaアプリケーションを選ぶ

フレームワークプロジェクトの作成

同じくワークスペースのWindowの左下の”+”マークから、”New Project…”を選んで、フレームワークプロジェクトの作成と追加。

この時、プロジェクトの種類はCocoaフレームワークを選ぶ

playgroundでフレームワークをimport出来るように、ここでフレームワークをビルドしておく。

フレームワークの中のソースを変更する毎にビルドしてから、playgroundの実行を行う事。

プレイグラウンドの作成

ワークスペースのWindowの左下の”+”マークから、今度は”New file…”を選んで、Playgroundファイルの作成と追加。

この時、ファイルの種類はPlaygroundを選ぶ。ここで気がついたが、Playgroundはファイルであり、プロジェクトではないために、ファイルの共有が出来ないのかもしれない。

playgroundからフレームワークをimportする

フレームワークの名称がPGWS2FMなので、”import PGWS2FM”を追加する。

PlaygroundSupportはplaygroundでNSViewやNSViewControllerを使用するためのユーティリティフレームワーク。

@testableをつけてimportすると、同じモジュールにあるように扱えます。

ここでの目的は、アプリケーションプロジェクトの支援なので、@testableをつけてます。

//: Playground - noun: a place where people can play

import Cocoa
import PlaygroundSupport
@testable import PGWS2FM

var str = "Hello, playground"

そのほかに、playgroundの自動実行の停止や、ショートカットの設定を行うと便利。

XcodeのPlaygroundが僕の無茶苦茶なコードを勝手に実行して自滅するので手動実行にして実行ショートカットキーを割り当てた

使用例1：カスタムViewを作成し、プレイグラウンドで試す

適当なNSViewのサブクラスPGWS2View.swiftをアプリケーションプロジェクトに作る。

import Cocoa

class PGWS2View: NSView
{
    // 背景色
    var backgroundColor: NSColor = NSColor.blue

    override func draw(_ dirtyRect: NSRect)
    {
        super.draw(dirtyRect)

        // Drawing code here.
        backgroundColor.set()
        NSBezierPath.fill(self.bounds)
    }
}

作成後、フレームワークプロジェクトにDrag&Dropして、フレークワークをビルドする。

これで、PlaygroundでPGWS2Viewが使えるようになる。以下のソースをPlaygroundに打ち込むとTimeLineに青い四角が現れるはず。

//: Playground - noun: a place where people can play

import Cocoa
import PlaygroundSupport
@testable import PGWS2FM

var str = "Hello, playground"

var theView: PGWS2View
let theRect = NSMakeRect(0,0,100,100)

theView = PGWS2View(frame:theRect)

//theView.backgroundColor = NSColor.black

PlaygroundPage.current.liveView = theView

PlayGroundを実行させると以下のような画面になる。

エラーが起きた場合は最初に、以下の3点を確認する事。よく忘れる。

フレームワークのビルドを忘れていないか？
フレームワークにファイルをコピーし忘れていないか？
palygroundをマニュアル起動にしたのに、実行ボタンを押し忘れていないか?

なお、TimeLine表示にするには、Window左上の丸が2つあるマークを押す必要がある。

私は間抜けなのでこれに気がつくのに時間がかかった。

うまく動いたら、コメントアウトされた行を有効にして、黒い四角を表示させてみてください。カスタムViewの作成が捗るような気がしてくるはずです。

使用例2：アプリケーションプロジェクト内のViewControllerをプレイグラウンドで試す

次は、ViewControllerです。storyboadrdから再生したViewControllerを表示させます。

ソースコードは、動作確認のための、アクションを2つ。ログを出力後に、ViewControllerを閉じるだけの簡単なコードです。

import Cocoa

class ViewController: NSViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        // Do any additional setup after loading the view.
    }

    override var representedObject: Any? {
        didSet {
        // Update the view, if already loaded.
        }
    }

    @IBAction          func okOperation(_ sender: Any?)
    {
        print("OK_BUTTON")
        self.dismissViewController(self)
    }

    @IBAction override func cancelOperation(_ sender: Any?)
    {
        print("Cancel_BUTTON")
        self.dismissViewController(self)
    }

}

OKボタンとCancelボタンを配置して、actionの設定をします。

SotorybordIDを設定します。ここでは、クラス名と同じく、ViewControllerにしてます。

最後に、アプリケーションプロジェクトからフレームワークプロジェクトにファイルをDrg&Dropします。ファイルの参照がフレームワークプロジェクトに追加されるようにするためです。

ここで、フレームワークのビルドを忘れずに。

これで、PlaygroundでViewControllerが使えるようになる。以下のソースをPlaygroundに打ち込むとTimeLineにボタンが2つ見えるはず

//: Playground - noun: a place where people can play

import Cocoa
import PlaygroundSupport
@testable import PGWS2FM

let theBundle = Bundle(identifier:"com.mindto01s.PGWS2FM")

let theStoryboard = NSStoryboard(name: "Main",
                                     bundle:theBundle)

var vc:ViewController

vc = theStoryboard.instantiateController(withIdentifier: "ViewController") as! ViewController

PlaygroundPage.current.liveView = vc

実行させると、以下のようにボタンが2つ表示される。

ここで、OKボタンを押すとログに”OK_BUTTON”と表示され、アクションが実行されていることが確認できます。

ここでのコツは、

Storyboradをフレームワークに登録することを忘れない
フレームワークに入っているリソースはメインバンドル内では無い事を忘れない。

この2点さえ覚えておけば、普通に使えてます。

参考文献とソースコード

プロジェクトファイル

XcodeのPlaygroundが僕の無茶苦茶なコードを勝手に実行して自滅するので手動実行にして実行ショートカットキーを割り当てた

これを読まなかったら、操作方法がウザすぎて、試作環境は作れなかった。

落穂拾い 2017/07/14

Fri, 14 Jul 2017 00:00:00 +0900

落穂拾い 2017/07/14

Apple Developer Center

ガイド

Apple File System Guide (watchOS|tvOS|iOS|macOS) アップデート
Apple URL Scheme Reference (watchOS|Safari (Mobile)|Safari|iOS|macOS) マイナーチェンジ
In-App Purchase Programming Guide (tvOS|iOS|macOS) アップデート
Markup Formatting Reference (Xcode Developer Tools) マイナーチェンジ
Receipt Validation Programming Guide (tvOS|iOS|macOS) アップデート
TVML Programming Guide (tvOS) アップデート

サンプルコード

AlignmentGuides: AppKit Haptic Feedback Filtering using NSAlignmentFeedbackFilter (macOS) マイナーチェンジ
Fox 2: SceneKit WWDC 2017 sample code (tvOS|iOS|macOS) 初版
ManagingContactsUI: Using ContactsUI View Controllers and Properties (iOS) 初版
Quartz2D for iOS (iOS) アップデート

テクニカルノートとQA

Handling Frame Drops with AVCaptureVideoDataOutput (iOS|macOS) 初版
Secure Kernel Extension Loading (macOS) マイナーチェンジ

リリースノート

What’s New in macOS (macOS) マイナーチェンジ

News and Updates - Apple Developer

swiftで迷路の脱出

Thu, 13 Jul 2017 00:00:00 +0900

swiftで迷路の脱出

swift playgrouds での8番目のプログラミング。今回は迷路の脱出。

こんな迷路を作るアプリケーションを作った。gifアニメの後半で迷路からの脱出経路を描画している。

青が壁、黒は通路、赤はスタートからゴールまでの順路、黄色は行き止まり。

ゴールまで達すれば、探索は終了するので、見探索の通路が残ります。

使い方

GUIからの使い方は、以下の通り。

アプリの起動
コマンド+N を押すか file -> New を選ぶと、迷路作成の開始
迷路が完成すると、すぐに迷路からの脱出経路の探索を開始する

(4) スタートは左下、ゴールは右上 (4) スライダーを左右に動かすと、迷路の作成の途中結果を確認できる。

Playgroundからも実行できる。今回も本当はこちらがメイン。

import Cocoa

let maze = MazeBoard(width:20, height:20) // 20 * 20の大きさの迷路を作る
maze.doDig(MazePos(1,1))                  // (1,1)の地点から迷路を彫り始める
let resolver = MazeResolver(maze)         // 迷路の脱出機を作る
resolver.resolve(MazePos(1,1))            // (1,1)の地点(左上)から開始
resolver.DebugPrint()                     // 結果の出力

このように書くと、以下のような出力が得られる。

# # # # # # # # # # # # # # # # # # # #
# S . * * x x x x x x x x x * . . . * #
# * . * x x * * * * * * * x . . * . * #
# * . * * * * . . . . . . * . * * . . #
# * . . * . . . * * * * . * . . . * . #
# * * . * . * * *   * * . . * * . * . #
# x * . * . . *         * . * . . * . #
# . . . * * . *   * *   * . . . * * . #
# . * * * . . *   * *   * * * * * * . #
# . * * . . *     *     * * * . . . . #
# . * * . * *   * *   * *     . * * * #
# . . * . * * * * *         * . . . . #
# * . * . * . . . . * * * * * * * * . #
# * . * . . . * * . . . . . . * * * . #
# * . . * x * * * * * x * * . * . . . #
# * * . * * * . . . * x * * . * . * * #
# x * . * * * . * . * x * * . * . * * #
# x x . . . * . * . * * * * . * . .   #
# * x * * . . . * . . . . . . * * . . #
# # # # # # # # # # # # # # # # # # # #

Sがスタート地点で、G(左下)がゴール地点です。(バグでゴールを.で塗りつぶしてしまってるけど) Xは行き止まりの通路、.が順路です。何も書かれていない場所は、探索していない通路です。

resolver.resolve(MazePos(1,1))                  // (1,1)の地点から迷路を彫り始める

この部分を

resolver.resolve(MazePos(1,1), { $0.DebugPrint() } )

このように変えると、作成途中の迷路が見れる。

ソースコードの解説

面倒なので、

「関東swift勉強会2017-7」　https://cocoa-kanto.connpass.com/event/61475/

で、解説します。

参考文献とソースコード

プロジェクトファイル

Swift Macアプリ開発入門

https://www.amazon.co.jp/Swift-Macアプリ開発入門―次世代iOS、macOSプログラマーのための-中山-茂/dp/487783396X これを読んで、macOSのアプリをサクサク作れるようになるとは思わないが、サンプルコードの選定が私の好みに合ってる。業務用のアプリケーションの雛型でなくて、学習用アプリケーションの雛型なのが良い感じ。

swiftで迷路の作成

Mon, 10 Jul 2017 00:00:00 +0900

swiftで迷路の作成

swift playgrouds での7番目のプログラミング。今回は迷路の作成。そして、Playgroundsからの脱皮してアプリケーションを作った。

こんな迷路を作るアプリケーションを作った。目的は、迷路を解くプログラムを作るための準備。

使い方

GUIからの使い方は、以下の通り。

アプリの起動
コマンド+N を押すか file -> New を選ぶと、迷路作成の開始
迷路が完成すると、ウインドウの下部のスライダーがenableになる。
スライダーを左右に動かすと、迷路の作成の途中結果を確認できる。

Playgroundからも実行できる。と、いうかこちらがメイン。

import Cocoa

let maze = MazeBoard(width:20, height:20) // 20 * 20の大きさの迷路を作る
maze.doDig(MazePos(1,1))                  // (1,1)の地点から迷路を彫り始める
maze.DebugPrint()                         // 迷路を出力

このように書くと、以下のような出力が得られる。

# # # # # # # # # # # # # # # # # # # #
# S * *         * *   * * *   * * * * #
#     *   * *   * *       *           #
# *       * *         *     *   * *   #
# * * * *   * * * * * * *   *     * * #
#           *           *     *     * #
#     *   * *   * * *   * *   * *     #
#   * *   * *     * *   * *   * * *   #
#   * *       *   *       *           #
#   * * * *       *   *     * * * *   #
#           * * * *     *     *       #
# * * * *     * * * *     *   *   * * #
#       * *         * *   * * *   * * #
#   *       * * *   * *     * *       #
#   * * *       *     * *     * *   * #
#     * * * *   * *   * * *         * #
# *   *   * *         *   * * * * * * #
# *   *       * * * *       * * *     #
# *       *             *           G #
# # # # # # # # # # # # # # # # # # # #

Sがスタート地点で、Gがゴール地点です。

maze.doDig(MazePos(1,1))                  // (1,1)の地点から迷路を彫り始める

この部分を

maze.doDig(MazePos(1,1), { $0.DebugPrint() } )

このように変えると、作成途中の迷路が見れる。

ソースコードの解説

面倒なので、

「関東swift勉強会2017-7」　https://cocoa-kanto.connpass.com/event/61475/

で、解説します。

参考文献とソースコード

プロジェクトファイル

コンピュータアルゴリズム事典

https://www.amazon.co.jp/Software-Technology-12-コンピュータアルゴリズム事典-奥村/dp/4874089135 Pascalで書かれてます。当初これに載っていた、「壁を伸ばす」アリゴリズムで書いていたが、「穴を掘る」アルゴリズムに変更した。しかし、進めなくなったら、分岐箇所からもう一度伸ばす考え方は同じはず。
Swift Macアプリ開発入門

https://www.amazon.co.jp/Swift-Macアプリ開発入門―次世代iOS、macOSプログラマーのための-中山-茂/dp/487783396X これを読んで、macOSのアプリをサクサク作れるようになるとは思わないが、サンプルコードの選定が私の好みに合ってる。業務用のアプリケーションの雛型でなくて、学習用アプリケーションの雛型なのが良い感じ。

落穂拾い 2017/07/04

Tue, 04 Jul 2017 00:00:00 +0900

落穂拾い 2017/07/04

Apple Developer Center

ガイド

Advertising Guide for Apple News (iAd System JS|iAd Producer|iOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ

テクニカルノートとQA

Adding In-App Purchase to Your Applications (iOS|macOS) アップデート
How to reproduce bugs reported against Mac App Store submissions (Xcode Developer Tools|macOS) アップデート
In-App Purchase FAQ (iOS|macOS) マイナーチェンジ

News and Updates - Apple Developer

ソースコード用にcssを書いた

Mon, 03 Jul 2017 00:00:00 +0900

ソースコード用にcssを書いた

今まで、sphinxで書いたソースコードがソフト改行されていたために、読みづらかった。

ソフト改行されるのは、所定の矩形に入れるためなので、仕方がない事だと思っていた。

ググるとcssをうまく設定すると改行せずに横スクロールさせる設定があるとの事。

以下のコードを使っているcssファイルに追加するだけ。

/* ソースコードは改行しないで、スクロールさせる */

div.highlight pre {
    white-space: pre;
    word-wrap: normal
}

div.highlight {
    overflow:auto;
}

当然、Safariでしか確認していない。

swiftでアナグラム

Sun, 02 Jul 2017 00:00:00 +0900

swiftでアナグラム

swift playgrouds での6番目のプログラミング。今回はアナグラムの生成。

アナグラムとは、単語の文字をいくつか入れ替えることで、別の単語を作り上げて、別の意味を持たせる遊びです。

ノストラダムスがナンダッテー ΩΩΩ に出てくる文字を入れ替えて別の単語にするアレです。

“/usr/share/dict/words” に英単語集があります。この単語集とコレクションクラスの各種メソッドを使って、与えられた英単語からアナグラムになる英単語を出力します。

入力例

let theAnagram = MTFAnagrams()
print(theAnagram.anagrams("thinker")) // thinker(思想家) -> rethink(再考)
print(theAnagram.anagrams("canoe"))   // canoe(カヌー) -> ocean(海)
print(theAnagram.anagrams("orange")) // orange(オレンジ) -> onager(投石機)
print(theAnagram.anagrams("valencia")) // valencia(スペインの地名？) -> valiance(たれ布?カーテン?)

出力例

["rethink"]
["acone", "ocean"]
["onager"]
["valiance"]

ソースコードを分けた

ソースコードを分けて、別ファイルに入れると実行スピードが上がる。おそらく、別ファイルにすることでトレース機能が及ばなくなるのだと思われる。

アナグラムを探し出すクラスは以下のようになってます。ファイルanagrams.swiftに書いている。

import Foundation

public struct MTFAnagrams
{
    let wordSet: Set<String>

    public init()
    {
        //   - テキストファイルから読み込み、単語の集合を作る
        let wordArray:[String] =
            try! String.init(contentsOfFile:"/usr/share/dict/words")    // ファイルから読み込み
                .components(separatedBy:"\n")                               // 改行で分割し

        self.wordSet   = Set<String>(wordArray) // 単語の存在確認のために、集合にしておく。
    }

    public func anagrams(_ word:String) -> Set<String>
    {
        // 1単語毎に単語を入れ替えた仮のアナグラムを生成。
        let anagrams = Set(
            word.characters // 文字毎に分解
                .flatMap{ String($0) }        // 型を文字列に変換
                .permutations()               // 文字順を入れ替えた仮のアナグラムの配列を生成
                .map{ $0.joined() }           // 1文字毎だったものを連結
                .flatMap                      // 仮のアナグラムが単語集wordSetにある場合は、アナグラムである。元の文字列と同じものは除く
                {
                    (anagram:String) -> String? in

                    word != anagram && self.wordSet.contains(anagram) ? anagram : nil
                }
        )

        return anagrams
    }
}

swiftで特徴的なのは、クラスやメソッドの可視スコープです。今まで、プレイグラウンドで1つのファイルでやっていたので気がつかなかったが、ファイルや、フレームワークがスコープの範囲になっています。

ファイルを分けたことで、別ファイルから利用するには、 “public” キーワードを付けました。

アルゴリズムに関してはコメントを参考にしてください。

また、アナグラムを作るのに、arrayにメソッド “permutations” を追加しました。ファイル “ArrayExtension.swift” にエクステンションを書いています。

import Foundation

extension Array
{
    // 各要素の順列違いを全て生成する。n!個のパターンを作る。nが8を越えると猛烈に遅くなる。
    // 注意：nが大きくなると爆発的に巨大な数になるのでカードゲームのシャッフルなどには使わないこと
    // https://stackoverflow.com/questions/34968470/calculate-all-permutations-of-a-string-in-swift
    public func permutations() -> [[Element]]
    {
        var scratch = Array(self) // This is a scratch space for Heap's algorithm
        var result: [[Element]] = [] // This will accumulate our result

        // Heap's algorithm
        func heap(_ n: Int)
        {
            if n <= 1
            {
                result.append(scratch)

                return
            }

            for i in 0..<n-1
            {
                heap(n-1)
                let j = (n%2 == 1) ? 0 : i
                swap(&scratch[j], &scratch[n-1])
            }

            heap(n-1)
        }

        // Let's get started
        heap(scratch.count)

        // And return the result we built up
        return result
    }
}

これは、可能な組合せの配列を返すメソッドです。コードは stackOverFlow から引用したものをコンパイルが通るように修正を加えただけ。

参考文献のサンプルコードからの移植の感想

元のコードはC++のSTLを使ったサンプルコードです。以下C++やObjective-Cとの違いの感想です。

C++よりもエラーメッセージがわかりやすい
クロージャーのおかげで、関数オブジェクトの事を考えなくて良く楽
unixのフィルターを使った1行プログラミングに近い感じがする
forよりもmapを使うと見た目がスッキリする事が多い
今回は使用しなかったが、forとカウンタ変数を使うよりも数列 ( 1…5 ) の表記とmapを組み合わせた方がキレイ。
reduceよりも使えるならばjoinedを使うと見た目がキレイ。

後の課題は、オプショナルとアンラップがまだよくわかっていない。

参考文献とソースコード

プロジェクトファイル

　STL標準テンプレートライブラリによるC++プログラミング

https://www.amazon.co.jp/STL―標準テンプレートライブラリによるC-プログラミング-Higher-education-computer/dp/4795296987

Swiftで8人の女王その2

Fri, 30 Jun 2017 00:00:00 +0900

Swiftで8人の女王その2

reduceの代わりにjoinを使うとメソッドdebugPrintが簡潔にかけるようになった。文字列の結合や配列の結合くらいでは、joinの方が見た目が綺麗。

// debug用出力
func debugPrint()
{
    // 数列に対するmap&joinedを行い、デバッグ文字列を作成する
    print(
        ( 0..<queens.count ).map
            {
                i -> String in // ここで引数に名前をつけないと内側のmapのクロージャでアクセスできない。

                (0..<sizeN).map{ $0 == queens[i] ? " q" : " ." }.joined() + "\n"

            }.joined()
    )
}

メソッドresolveの方はreduceの代わりにflatMapを二重にかけた方が簡潔に見える。

func resolve() -> [EQBoard]
{
    precondition(queens.count <= self.sizeN)

    func resolve_intarnal( _ count:Int, _ boards:[EQBoard]) -> [EQBoard]
    {
        return count == 0 ? boards :
            resolve_intarnal(
                                count - 1,
                                boards.flatMap
                                {
                                    i -> [EQBoard] in // この記述がないと曖昧(ambiguous)でわからぬとエラーが出る
                                    (0..<i.sizeN).flatMap
                                    {
                                        i.tryAddAQueen($0) ? i.boardAddAQueen($0) : nil
                                    }
                                })
    }

    return resolve_intarnal(self.sizeN, [self])
}

参考文献とソースコード

プロジェクトファイル

　Logo 人工知能へのアプローチ

https://www.amazon.co.jp/Logo-人工知能へのアプローチ-ラジオ技術選書-150-祐安-重夫/dp/4844301500

Swiftで8人の女王

Tue, 27 Jun 2017 00:00:00 +0900

Swiftで8人の女王

swift playgrouds での5番目のプログラミング。今回は8Queenパズル。

チェスのクイーンは、チェス盤上で最も自由に動けまわれるコマです。縦横斜めの8方向に、任意の数だけ駒を進めることが出来ます。将棋でいう飛車と角を合わせた動きです。

このクイーンを8x8のチェス盤上に8個、お互いに取られないように配置するのが8Queenパズルです。

解法は 8Queen から見てゆくとわかりやすいです。

参考文献ではバックトラッキングの例題として書かれて素直に移植したつもりだった。しかし書いているうちに、深さ優先の検索でなく広さ優先検索になっていた。

作ったクラスの動き

以下のようにチェス版の大きさを指定して、結果を出力させます。sizeは板の大きさです。8Queenなので8の大きさにしてます。

let queen = EQBoard(size:8)
let QueenAnser = queen.resolve()

QueenAnser.map{ $0.debugPrint() }
print("---\(QueenAnser.count)")

出力結果は以下のようになります。

 q . . . . . . .
 . . . . q . . .
 . . . . . . . q
 . . . . . q . .
 . . q . . . . .
 . . . . . . q .
 . q . . . . . .
 . . . q . . . .

 q . . . . . . .
 . . . . . q . .
 . . . . . . . q
 . . q . . . . .
 . . . . . . q .
 . . . q . . . .
 . q . . . . . .
 . . . . q . . .

 q . . . . . . .
 . . . . . . q .
 . . . q . . . .
 . . . . . q . .
 . . . . . . . q
 . q . . . . . .
 . . . . q . . .
 . . q . . . . .

    .
    .
    .

 . . . . . . . q
 . . . q . . . .
 q . . . . . . .
 . . q . . . . .
 . . . . . q . .
 . q . . . . . .
 . . . . . . q .
 . . . . q . . .

---92

qの文字はQueenの位置を示しています。最後の–92は、結果が92パターンの配置があるとの結果です。

作ったクラスの中み

構造体の名前は “EQBoard” 、プロパティは2つ、メソッド数は 6つ。

初期化メソッドが2つ、デバッグメソッドが1つなので、計算をする部分は事実上3つのメソッドで行なっています。

で、メインの3つのメソッドは以下の通り。

resolve

ここで、解を求める
boardAddAQueen

今の盤にqueenを1個追加した盤を返す。resolveの補助。
tryAddAQueen

今の盤に配置可能かのチェックを行う。resolveの補助。

ソースはこんな感じ。

func resolve() -> [EQBoard]
{
    precondition(queens.count <= self.sizeN)

    func resolve_intarnal( _ count:Int, _ boards:[EQBoard]) -> [EQBoard]
    {
        if count == 0
        {
            return boards;
        }

        // 与えられた板の次のrawの配置の配列を計算する
        return resolve_intarnal( count - 1,
                                 boards.reduce([])// 計算結果を配列にひとまとめにする
                                 {
                                    let i = $1

                                    return $0 + ( 0..<i.sizeN ) // 横のマスの数だけ、置いて試す
                                        .flatMap
                                        {
                                            i.tryAddAQueen($0) ? i.boardAddAQueen($0) : nil
                                        }
                                })
    }

    return resolve_intarnal(self.sizeN, [self])
}



// queenを1個追加した盤を返す
func boardAddAQueen(_ newQueen: Int) -> EQBoard
{
    precondition(newQueen >= 0)
    precondition(newQueen < self.sizeN)
    precondition(queens.count < self.sizeN)

    return EQBoard(size:self.sizeN, queens: self.queens + [newQueen])
}


// 配置可能かのチェックを行う
func tryAddAQueen(_ newQueen: Int) -> Bool
{
    precondition(newQueen >= 0)
    precondition(newQueen < self.sizeN)

    // 縦方向と左右の斜めにQueenがないかチェックする
    return ( self.queens.enumerated().map
                {
                    ( $0.element == newQueen)                                  || /* 縦が一致       */
                    ( $0.element == newQueen - self.queens.count + $0.offset ) || /* 斜め左方向が一致 */
                    ( $0.element == newQueen + self.queens.count - $0.offset ) ?  /* 斜め右方向が一致 */
                     false : true
                }.filter{ $0==false }.count ) == 0
}

解説は、次回のCocoa勉強会で行います。じゃあね。

参考文献とソースコード

プロジェクトファイル

　Logo 人工知能へのアプローチ

https://www.amazon.co.jp/Logo-人工知能へのアプローチ-ラジオ技術選書-150-祐安-重夫/dp/4844301500

落穂拾い 2017/06/26

Mon, 26 Jun 2017 00:00:00 +0900

落穂拾い 2017/06/26

Apple Developer Center

ガイド

Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ

テクニカルノートとQA

Building from the Command Line with Xcode FAQ (iOS|Xcode Developer Tools|macOS) アップデート
Secure Kernel Extension Loading (macOS) 初版
Setting Refresh Rates on ProMotion and Traditional Displays (tvOS|iOS|macOS) 初版
Version Numbers and Build Numbers (iOS|macOS) マイナーチェンジ

リリースノート

Foundation Release Notes (macOS 10.12 and Earlier) (watchOS|tvOS|iOS|macOS) アップデート
Foundation Release Notes for macOS 10.13 and iOS 11 (watchOS|tvOS|iOS|macOS) アップデート
What’s New in Safari (watchOS|tvOS|Safari (Mobile)|Safari|iOS|macOS) アップデート

News and Updates - Apple Developer

swiftで最小限タートルグラフィック

Fri, 23 Jun 2017 00:00:00 +0900

swiftで最小限タートルグラフィック

swift playgrouds での4番目のプログラミング。今回はタートルグラフィックスの実装。

機能は最小限の LOGO　の機能で有名なタートルグラフィックスをswiftで実装した。

実装したコマンドは、以下の6つ。カラーは未実装。

right
left
forward
backward
penDown
penUp

これらのコマンドの組み合わせで、以下のようなグラフィックを表現できる。

作ったクラスとその概要

ユーティリティー的なコードを除外すると、以下のような単純なコードです。

struct tinyTurtle
{
    let path             = NSBezierPath()
    var position         = CGPoint(x:0, y:0) // 絶対値での現在地
    var degree           = CGFloat(90.0)     // 角度。水平方向の右側が0度なので最初は上を向ける
    var penState         = true              // ペンを置いているか否か

    init()
    {
        self.path.move(to: position)
    }

    // 現在の方向から計回りに角度を曲げる
    mutating func right(_ degree: CGFloat)
    {
        self.degree -= degree
    }

    // 逆回転も追加
    mutating func left(_ degree: CGFloat)
    {
        right(-degree)
    }

    // 現在の位置から前進
    mutating func forward(_ length: CGFloat)
    {
        // 角度と長さと現在地から、前進後の位置を求める
        let radian   = self.degree * (CGFloat.pi / 180) //ラジアンに変換
        let vector   = length * CGPoint(x: cos(radian), y: sin(radian))
        let absPoint = self.path.currentPoint + vector

        if penState
        {
            self.path.line(to: absPoint)
        }
        else
        {
            self.path.move(to: absPoint)
        }
    }

    // バックも追加
    mutating func backward(_ length: CGFloat)
    {
        forward(-length)
    }

    // 描画用のペンの上げ下げ
    mutating func penDown()
    {
        self.penState = true
    }

    mutating func penUp()
    {
        self.penState = false
    }

    // 絶対値で示す位置へ移動 描画ポイントが迷子になっちゃうので追加
    mutating func goto(_ x: CGFloat, _ y: CGFloat)
    {
        self.position = CGPoint(x:x, y:y)
        self.path.move(to: self.position)
    }

    func draw()
    {
        self.path.stroke()
    }
}

解説は、関東swift勉強会2017-6 で行います。

使い方

多角形を描く。

NSImage.imageWithBlock(NSSize(width:300, height:200))
{
    var t = tinyTurtle()

    t.goto(150,100)

    func poly(_ n: Int, _ size: CGFloat)
    {
        for _ in 1...n
        {
            t.forward(size)
            t.right(360.0 / CGFloat(n))
        }
    }

    poly(3, 50)
    poly(5, 50)
    poly(8, 50)

    t.draw()
}

出力結果は、以下のようになる。

ユーティリテーメソッドを利用すると、以下のようにもかける。

tinyTurtle.tinyTurtleWithBlock(NSSize(width:300, height:200))
{
    t in

    func poly(_ n: Int, _ size: CGFloat)
    {
        for _ in 1...n
        {
            t.forward(size)
            t.right(360.0 / CGFloat(n))
        }
    }

    poly(3, 50)
    poly(5, 50)
    poly(8, 50)
}

他にも、コッホ曲線を描く場合はこんな感じになります。

tinyTurtle.tinyTurtleWithBlock(NSSize(width:300, height:200))
{
    t in

    func koch(_ size: CGFloat, _ angle:CGFloat, _ n:Int)
    {
        if n == 0
        {
            t.forward(size)
            return
        }
        else
        {
            koch(size/3, angle, n-1)
            t.left(angle)
            koch(size/3, angle, n-1)
            t.right(angle * 2)
            koch(size/3, angle, n-1)
            t.left(angle)
            koch(size/3, angle, n-1)
        }
    }

    t.goto(50,20)
    t.right(90)

    koch(200, 60, 5)
}

結果は、以下のようになります。

参考文献とソースコード

プロジェクトファイル

　Logo 人工知能へのアプローチ

https://www.amazon.co.jp/Logo-人工知能へのアプローチ-ラジオ技術選書-150-祐安-重夫/dp/4844301500

swiftで三段論法

Thu, 22 Jun 2017 00:00:00 +0900

swiftで三段論法

swift playgrouds での3番目のプログラミング。今回は、三段論法を使用する人工知能っぽい何か。

機械に推論させるのは、難しいと思われるかもしれない。三段論法くらいであれば、結構単純なアルゴリズムで推論が実行できる。

大雑把な解説

プログラムは、structが一つ、メソッドは6つ、プロパティが1つ、の単純な構成です。

大きく分けて、2つの部分からなっています。

三段論法を実行する部分
- プロパティ: “知識集” 三段論法で使用する事実を保持します
- メソッド　: “デバッグ表示” デバッグ用に “知識集” の内容を出力します。
- メソッド　: “登録” 知識の登録をします。
- メソッド　: “検索” 引数で与えられた単語の知識を検索します。
- メソッド　: “推論” 引数2つで与えられた知識の真偽を推論します。
自然言語の解析部分
- メソッド　: “分ち書き” 文字列を単語に分けます。
- メソッド　: “入力” 与えられた文字列の内容に従って、知識の登録、知識の真偽を判定します。

データ構造も非常にシンプルです。

var 知識集: [(lhs: String, rhs: String)] = []

タプルの配列です。「lhsはrhsである」との形式で知識を溜め込みます。

例えば、「ソクラテスは人間です」は、タプルとして

(lhs: "ソクラテス", rhs: "人間")

とタプルの形式にして、プロパティ “知識集” に蓄積されてゆきます。

参考文献とソースコード

プロジェクトファイル

　Logo 人工知能へのアプローチ

https://www.amazon.co.jp/Logo-人工知能へのアプローチ-ラジオ技術選書-150-祐安-重夫/dp/4844301500

swiftでハノイの塔

Thu, 22 Jun 2017 00:00:00 +0900

swiftでハノイの塔

swift playgrouds で2番目に書いたプログラム。

機能はパズルハノイの塔　の手順を出力するだけ。

手順は以下のような、アニメーション(wikipediaより引用)ではなくて、単なる文字列です。

作った関数

func hanoi(diskCount n: Int64)  -> [(pickUp: String, putDown: String)]

今回のメイン関数。円盤の枚数を与えると、手順をタプルのリストとして返す。 “pickUp” から “putDown” へ円盤を移動する。

func printHanoi01(hanoiArray: [(pickUp: String, putDown: String)])

関数 “hanoi” の表示をログに出力するための関数。

printHanoi01(hanoiArray: hanoi(diskCount:3))

上記のように評価すると、

(pickUp: "left", putDown: "right")
(pickUp: "left", putDown: "center")
(pickUp: "right", putDown: "center")
(pickUp: "left", putDown: "right")
(pickUp: "center", putDown: "left")
(pickUp: "center", putDown: "right")
(pickUp: "left", putDown: "right")

と出力される。

func hanoi(diskCount n: Int64)  -> [(pickUp: String, putDown: String)]

こちらは、出力を日本語にして見た。

同じく出力は以下のようになる。

円盤を 左側 から 右側 に移動する
円盤を 左側 から 中央 に移動する
円盤を 右側 から 中央 に移動する
円盤を 左側 から 右側 に移動する
円盤を 中央 から 左側 に移動する
円盤を 中央 から 右側 に移動する
円盤を 左側 から 右側 に移動する

コードを書いての感想

関数hanoiの中で、関数hanoi_internalを定義して使っている。Pascal風にローカル関数が書けるようになったのは便利。

hanoi本体は以下のような感じです。

// お皿の枚数を渡すと、ハノイの塔の手順を示す関数
func hanoi(diskCount n: Int64)  -> [(pickUp: String, putDown: String)]
{
    // 関数の中で関数定義ができる
    func hanoi_internal(diskCount n: Int64, from x:String, to y:String, work z:String) -> [(pickUp: String, putDown: String)]
    {
        if n != 0
        {
            return hanoi_internal( diskCount:n - 1, from:x, to:z, work:y)
                    + [(pickUp: x, putDown: y)]
                    + hanoi_internal( diskCount:n - 1, from:z, to:y, work:x)
        }
        else
        {
            return []
        }
    }

    return hanoi_internal(diskCount:n, from:"left", to:"right", work:"center")
}

hanoi_internalを無名関数にしてより簡潔に表記する方法がありそうだが見当たらなかった。

無名関数の中で自分自身へのポインターを示す特殊なキーワードがありそう。引数だと$0, $1, $2…などの表記があるので、$$がや$_あたりにあれば良いなと妄想中。

// こんな表記ができると最高なんだが...... $_を関数自身へのポインターとみなした場合
func hanoi(diskCount n: Int64)  -> [(pickUp: String, putDown: String)]
{
    return {
                diskCount n: Int64, from x:String, to y:String, work z:String)
                -> [(pickUp: String, putDown: String)] in

                if n != 0
                {
                    return $_( diskCount:n - 1, from:x, to:z, work:y)
                            + [(pickUp: x, putDown: y)]
                            + $_( diskCount:n - 1, from:z, to:y, work:x)
                }
                else
                {
                    return []
                }
    }(diskCount:n, from:"left", to:"right", work:"center")
}

参考文献とソースコード

プロジェクトファイル

　Logo 人工知能へのアプローチ

https://www.amazon.co.jp/Logo-人工知能へのアプローチ-ラジオ技術選書-150-祐安-重夫/dp/4844301500

MacPortsでInstallしたPythonを有効にした時のメモ

Sun, 18 Jun 2017 00:00:00 +0900

MacPortsでInstallしたPythonを有効にした時のメモ

解決するのに非常に以外に時間がかかった。

MacPorts側の解決。

sudo port select pip pip34
sudo port select python python34
sudo port select python3 python34
sudo port select sphinx py34-sphinx

ここまでは、install時にコメントが出るので簡単。

さらにPython系のツール群へパスを通すために、bash_profileに以下を追加。

# Python系のツール群へパスを通す
export PATH="/opt/local/Library/Frameworks/Python.framework/Versions/3.4/bin:$PATH"

このパスの位置がMacPortsの流儀のようで探すのに苦労した。

MacPortsでインストールしたツールは、/opt/local/bin/へシンボリックリンクを貼が貼られる。

一方、pipでinstallしたものは、シンボリックリンクは貼られない。pipはMacPortsの事は知らないので当然か。

自分でツール毎にシンボリックリンクを作るか、/opt/local/Library/Frameworks/Python.framework/Versions/3.4/binへパスを通すか迷ったが、パスを通す方を選んだ。

落穂拾い 2017/06/16

Fri, 16 Jun 2017 00:00:00 +0900

落穂拾い 2017/06/16

Apple Developer Center

ガイド

Playground Book Format Reference (Xcode Developer Tools) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS) マイナーチェンジ

サンプルコード

Checking and Requesting Access to Data Classes in Privacy Settings (iOS) アップデート
SourceView: Using NSOutlineView with NSTreeController (macOS) アップデート

テクニカルノートとQA

Launching the App Store from an iOS application (iOS) アップデート
Manual Code Signing for both iOS and tvOS (iOS) マイナーチェンジ
Obtaining the localized application name in Cocoa (macOS) アップデート
Setting up Xcode to automatically manage your provisioning profiles (iOS|Xcode Developer Tools|macOS) マイナーチェンジ

渦巻く幻燈

Thu, 15 Jun 2017 00:00:00 +0900

渦巻く幻燈

swift playgrouds で初めて書いたプログラム。

機能はランダムドット画像を少しだけ回転と拡大を加えた図を表示するだけ。

playgroudsは書き捨ての実験プログラムにはちょうど良い手軽さ。昔読んだけど試さなかったアルゴリズムの本のコードを色々と実験したら面白そうだ。

回転を大きくすると螺旋を認識できなくなる

同じランダムドット画像を2枚重ねて見ているような図。重ね方は矩形の真ん中を中心点にして、回転、拡大している。そのため、プログラムコード自体にも、出力した画像データにも螺旋構造は存在しない。

回転角度:0 , 拡大率:1.1

回転はなし、拡大だけの場合は、「爆発している感」がある。

回転角度:2 , 拡大率:1.1

回転2度、拡大の場合は、「渦巻いてる感」が出てくる。

回転角度:3 , 拡大率:1.1

回転2度、拡大の場合は、「渦巻いてる感」が出てくるが、角度2と対して変わらないかな？

回転角度:10 , 拡大率:1.1

回転10度、拡大の場合は、「渦巻いてる感」が真ん中の方だに存在する。真ん中の方がドットの間の間隔が狭いからかもしれない。爆発している感じもなくなる。

回転角度:20 , 拡大率:1.1

回転20度、拡大の場合は、「渦巻いてる感」も、「爆発している感」もさっぱりなくなる。

図形とは認識できないランダムドットでも条件が加われば「フレーザーの渦巻き錯視」と同じような錯覚が生じているように見える。

参考とソースコード

プロジェクトファイル

コンピューターワンダーランド p78

http://www.hakuyo-sha.co.jp/science/コンピュータ・ワンダーランド/
フレーザー錯視の渦巻き錯視の複製

http://www.psy.ritsumei.ac.jp/~akitaoka/FraSpr.html

sphinx1.6でpdf出力できないのは私の設定ミスでしたその2

Tue, 13 Jun 2017 00:00:00 +0900

sphinx1.6でpdf出力できないのは私の設定ミスでしたその2

今度は、html出力時に動作がおかしい

“language = ‘ja‘“だとsphinxcontrib.tikzの出力がエラーになる。

仕方がないので、makefileに以下のような記述を追加してエラーを回避。

# html出力でlanguageがjaだとTikZ Extentionがエラーを吐く。理由は不明。
html: Makefile makeBB
    @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -Dlanguage='en'

# こっちは素直にbbを作ってからコンパイル
latexpdf: Makefile makeBB
    @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

# TikZ使用時にxbbがないエラーを回避するために、画像ファイルにはxbbを作成しておく。
# (macPortでインストールした場合は、自動でxbbを生成しない設定らしい)
makeBB:
    find ./source -name \*.png -or -name \*.jpg -or -name \*.pdf \
    | while read theFile; do extractbb $$theFile; done

latexもpythonもわかっていないので、原因は不明。

原因の予想

sphinx1.6のLaTeXBuilder出力の方法がlatexmkを使うように変更になった。 (http://www.sphinx-doc.org/en/stable/builders.html#sphinx.builders.latex.LaTeXBuilder)

2. sphinxcontrib.tikzの中ではconfig.latex_engineで設定されているlatexを使っている。 (https://bitbucket.org/philexander/tikz/src/36f13083d61e91eb7cfea6f1ed959118749e371c/sphinxcontrib/tikz.py?at=master&fileviewer=file-view-default#tikz.py-245)

sphinxcontrib.tikzの記述がlatexmkと衝突するような記述になっているかもしれない。

対策

makeファイルを変更する対策は小手先の対策すぎる。

私の目的には、tikzは強力すぎるのでもう少し単純な描画言語で画像にマークアップしたい。

sphinxcontrib.tikzのコードを修正するか、新たにextensionを作るかで迷う。

どっちらにしても、pythonは読み書きできないのでこれから勉強する必要がある。

プロジェクトファイル

sphinx1.6でpdf出力できないのは私の設定ミスでした

Tue, 13 Jun 2017 00:00:00 +0900

sphinx1.6でpdf出力できないのは私の設定ミスでした

:doc:`../10/1c8b065d_3368_4c24_b50c_2f2045de0ac8`にて、sphinx1.6でpdf出力できないと書きました。

これは、間違いです。出来ます。

設定ミスしたところは、ファイルconf.pyの中のlanguage設定です。

jpとするのは間違い。

language = 'jp'

jaとするのが正しい。

language = 'ja'

jaはジャマイカではなくて、日本とのこと。

また、ビルドターゲットも変更があったようです。

以下のように、latexpdfjaを指定すると、エラーで止まります。./build/latex/makeにターゲット’all-pdf-ja’が存在しないとの事。

make latexpdfja

ビルドするには、以下のように、latexpdfを使用するだけで良い。

make latexpdf

落穂拾い 2017/06/13

Tue, 13 Jun 2017 00:00:00 +0900

落穂拾い 2017/06/13

Apple Developer Center

ガイド

Advertising Guide for Apple News (iAd System JS|iAd Producer|iOS) マイナーチェンジ
Apple File System Guide (watchOS|tvOS|iOS|macOS) アップデート
Apple Music API Reference (tvOS|iOS|macOS) 初版
Apple News Format Reference (iOS) マイナーチェンジ
Apple News Format: Advanced Design Tutorial (iOS) マイナーチェンジ
Apple News Format: Design Tutorial (iOS) マイナーチェンジ
Apple TV Markup Language Reference (tvOS) アップデート
Asset Catalog Format Reference (watchOS|tvOS|iOS|Xcode Developer Tools|macOS) マイナーチェンジ
Audio Session Programming Guide (watchOS|tvOS|iOS) アップデート
Business Chat Specifications (iOS) 初版
Configuration Profile Reference (tvOS|iOS|macOS) アップデート
Debugging with Xcode (Xcode Developer Tools) マイナーチェンジ
HLS Authoring Specification for Apple Devices (tvOS|iOS|macOS) マイナーチェンジ
Information Property List Key Reference (watchOS|tvOS|iOS|macOS) マイナーチェンジ
Markup Formatting Reference (Xcode Developer Tools) マイナーチェンジ
Mobile Device Management Protocol Reference (tvOS|iOS|macOS) アップデート
TVML Programming Guide (tvOS) アップデート
The Swift Programming Language (Swift 4) (Xcode Developer Tools) アップデート
Using Swift with Cocoa and Objective-C (Swift 4) (Xcode Developer Tools) アップデート
WebKit DOM Programming Topics (Safari (Mobile)|Safari|iOS|macOS) マイナーチェンジ

サンプルコード

AVCam-iOS: Using AVFoundation to Capture Images and Movies (iOS) アップデート
AVCamPhotoFilter: Using AVFoundation to Capture photos with image processing (iOS) アップデート
AccessibilityUIExamples (macOS) アップデート
AudioUnitV3Example: A Basic AudioUnit Extension and Host Implementation (iOS|macOS) アップデート
Example app using Photos framework (tvOS|iOS) アップデート
SpeedySloth: Using HealthKit to build a workout app for Apple Watch (watchOS) アップデート
TVML Catalog: Using TVML Templates (tvOS) マイナーチェンジ
TVML Guide: Core concepts in TVML and TVMLKit (tvOS) マイナーチェンジ

リリースノート

AppKit Release Notes (macOS 10.12 and Earlier) (macOS) アップデート
AppKit Release Notes for macOS 10.13 (macOS) アップデート
What’s New in Safari (watchOS|tvOS|Safari (Mobile)|Safari|iOS|macOS) アップデート
What’s New in iOS (iOS) アップデート
What’s New in macOS (macOS) マイナーチェンジ
What’s New in tvOS (tvOS) 初版
What’s New in watchOS (watchOS) アップデート
What’s New in Xcode (Xcode Developer Tools) 初版
Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ

TikZ Sphinx Extensionを導入のメモその3

Sun, 11 Jun 2017 00:00:00 +0900

TikZ Sphinx Extensionを導入のメモその3

tikz_latex_preambleにマクロを書くことで、簡潔にかけるようになった。

マークアップ

conf.pyのtikz_latex_preambleを追加。

tikz_latex_preamble = r'\newcommand{\markUpBox}[3]{\draw[red,ultra thick,rounded corners] (#1) rectangle (#2); \node[draw = red, fill=white, ultra thick,rounded corners, anchor=north east] at (#2) {\textbf{#3}}; }'

以下の表記法で、矩形とラベルを同時に書く。

\markUpBox{左下}{右上}{LabelName}

以下のように書くと、

.. tikz:: マークアップ
   :stringsubst:

   \node[anchor=south west] (image) at (0,0) {\includegraphics[width=10cm]{$wd/source/xcode01.png}};
   %\draw[step=1,lightgray] (0,0) grid (image.north east);
   %\draw[step=10,gray] (0,0) grid (image.north east);
   \markUpBox{0.5cm, 0.7cm}{2.2cm,5.7cm}{A};
   \markUpBox{8.0cm, 0.7cm}{9.7cm,5.7cm}{B};
   \markUpBox{2.5cm, 0.7cm}{7.5cm,5.7cm}{C};

以下のような画像が得られる。

感想

目的も果たせた。簡潔な表記も可能になった。conf.pyの表記が煩雑になるのは気にくわないが、許容範囲に収まった。

プロジェクトファイル

TikZ Sphinx Extensionを導入のメモその2

Sat, 10 Jun 2017 00:00:00 +0900

TikZ Sphinx Extensionを導入のメモその2

tikzを使う目的はスクリーンショット画像へのマークアップ。

プロジェクトファイル

html出力の設定

conf.pyのextensionsに以下を設定するだけ。

#
extensions = ['sphinxcontrib.tikz']

pdf出力の設定

作業中に、sphinxのバージョンを1.5系から1.6へアップデートしたら、pdfの生成がエラーで止まるようになった。色々とググると、sphinx1.6からは latexmk と呼ばれるコマンドを使うようになったらしい。

http://www.sphinx-doc.org/en/stable/builders.html#sphinx.builders.latex.LaTeXBuilder

Changed in version 1.6: Use of latexmk for make latexpdf on GNU/Linux and Mac OS X

latexmkのお勉強は後回しにして、pdf出力は今は諦める。

以下サンプル

単純な描画

上記のソースコード

.. tikz:: tikzで描いた図

    \draw[thick,rounded corners=8pt]
   (0,0)--(0,2)--(1,3.25)--(2,2)--(2,0)--(0,2)--(2,2)--(0,0)--(2,0);

画像ファイルの読み込み

既存の画像を読み込むには、フルパスを指定する必要がある。

フルパスの指定は、以下の手順。

オプション”:stringsubst:”を指定する文字列の置き換えを行う宣言をする。
“Makefile”があるディレクトリまでを、文字列”$wd”で示す。

上記のソースコード

.. tikz:: 画像ファイルの読み込み
   :stringsubst:

   \node {\includegraphics[width=10cm]{$wd/source/xcode01.png}};

マークアップの下準備のための、格子の描画

上記のソースコード

.. tikz:: 格子付き
   :stringsubst:

   \node[anchor=south west] (image) at (0,0) {\includegraphics[width=10cm]{$wd/source/xcode01.png}};
   \draw[step=1,lightgray] (0,0) grid (image.north east);
   \draw[step=10,gray] (0,0) grid (image.north east);

マークアップ

目的のマークアップ

上記のソースコード。

.. tikz:: マークアップ
   :stringsubst:

   \node[anchor=south west] (image) at (0,0) {\includegraphics[width=10cm]{$wd/source/xcode01.png}};
   %\draw[step=1,lightgray] (0,0) grid (image.north east);
   %\draw[step=10,gray] (0,0) grid (image.north east);
   \node[draw = red, fill=white, ultra thick,rounded corners, anchor=north east] at (2.2cm,5.7cm) {\textbf{A}};
   \draw[red,ultra thick,rounded corners] (0.5cm, 0.7cm) rectangle (2.2cm,5.7cm);
   \node[draw = red, fill=white, ultra thick,rounded corners, anchor=north east] at (9.7cm,5.7cm) {\textbf{B}};
   \draw[red,ultra thick,rounded corners] (8.0cm, 0.7cm) rectangle (9.7cm,5.7cm);
   \node[draw = red, fill=white, ultra thick,rounded corners, anchor=north east] at (7.5cm,5.7cm) {\textbf{C}};
   \draw[red,ultra thick,rounded corners] (2.5cm, 0.7cm) rectangle (7.5cm,5.7cm);

感想

latexのマクロで簡潔に書こうとしたが、そもそもどこに書けば良いのかわからない。latex_elements/preambleはlatexpdf出力の時のものなので、このtikz拡張には関係なし。

tikz_latex_preambleに書けば良いと思い書いたが、バックスラッシュだらけで意味不明になってバグが取れなかった。

目的は果たせたが、コレジャナイ感が満載。うーん。

sphinxのadmonition用にstyを書いた

Fri, 09 Jun 2017 00:00:00 +0900

sphinxのadmonition用にstyを書いた

デフォルトの設定のままだと、admonitionのhtml/pdf出力共に味気ない。 cssとstyファイルを書いて、少しだけ見た目を改善した。

html出力例 pdf出力例プロジェクトファイル

html出力の設定

conf.pyの末尾に以下を設定して、cssを適当にいじる。前回の sphinxのadmonition用にcssを書いたの続きとほぼ同じ。

# HTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したい
# http://sphinx-users.jp/reverse-dict/html/custom-css-js.html
def setup(app):
    app.add_stylesheet('custom.css') # ここはhtml用

画像ファイルや、cssは_staticディレクトリ直下へ配置する。

_staticにcustom.cssを配置

.
|-- Makefile
`-- source
    |-- _static
    |   |-- Caution.png    <--- これらは、アイコン用の画像
    |   |-- Danger.png
    |   |-- Note.png
    |   |-- Question.png
    |   |-- Tip.png
    |   |-- Warning.png
    |   `-- custom.css     <--- カスタムcss
    |-- _templates
    |-- admonition.rst
    |-- conf.py
    `-- index.rst

Tip

treeコマンドの出力をそのまま使うと、pdf出力で文字化けしてしまった。 tree --charset=C とオプションを指定することで、文字化けしない文字だけで構成することで回避できる。

custom.cssでは、以下のようになっている。

/* -- div.admonition ------------------------------------------------------ */

/*アイコンの下に付くように、タイトル文の表示位置の設定*/
div.admonition p.admonition-title {
    width: 65px;
    padding-top: 65px;
    text-align: center;
    font-weight: bolder;
    font-size: 18px;
    float:left;
    margin-left: -18px;
}

/*タイトル以外の文をアイコンを避けるように配置*/
p.last {
    padding-top: 0px;
    padding-right: 9px;
    padding-left: 100px;
    text-align: left;
    margin-top: 0px;
}
/*アイコンの配置と背景色の設定*/
div.caution{
    background: url(Caution.png) no-repeat;
    background-position: 9px 9px;
    background-size:64px 64px;

    border-radius: 10px 10px 10px 10px;
    background-color: #ededed;
    min-height: 110px;

    border: none;
}
.
.
.

pdf出力の設定

カスタム設定をまとめる、*.styファイルを作り、読み込ませる。

_staticにcustom.styを配置

.
|-- Makefile
`-- source
    |-- _static
    |   |-- Caution.png
    |   |-- Danger.png
    |   |-- Note.png
    |   |-- Question.png
    |   |-- Tip.png
    |   |-- Warning.png
    |   |-- custom.css
    |   `-- custom.sty     <--- カスタムsty
    |-- _templates
    |-- admonition.rst
    |-- conf.py
    `-- index.rst

_static/custom.styとアイコン群ををconf.pyのlatex_additional_filesを使って、build時にlatexが読み込める位置コピーさせる。 conf.pyに以下の設定を書き足す。

# preambleに長々と書きたく無いので、custom.styへ外出ししたものを読み込むようにする。
latex_additional_files = ['_static/custom.sty',
                          '_static/Caution.png', # admonitionで使用するアイコン画像群
                          '_static/Danger.png',
                          '_static/Note.png',
                          '_static/Question.png',
                          '_static/Tip.png',
                          '_static/Warning.png'
                          ]

custom.styを読み込むために、latex_elements/preambleに設定。 passoptionstopackagesを追加しているが自分はよくわかっていない。おそらく、tcolorboxがxcolorを要求するのだと思っている。 conf.pyに以下の設定を書き足す。

latex_elements = {
        .
        .
        .
        .
    'passoptionstopackages': r'\PassOptionsToPackage{dvipdfmx}{xcolor}',

    # 同じディレクトリにあるcustum.styを読み込む。
    'preamble': r'\usepackage{custom}',
}

custom.styでは、admonitionのマクロの置き換えを行なっている。

灰色の囲いは、tcolorboxパッケージを使って描画している
admonitionのマクロは、sphinx.styの中で定義されている以下のマクロを再定義して、実装している。
cautionはsphinxcautionマクロ、dangeはsphinxdangerがマクロ定義されている。

\usepackage{tcolorbox}

% sphinxadmonitionを一部上書きするためのHelperマクロ。アイコンと文字列を指定して囲みを作る。
\newenvironment{sphinxadmonition_helper}[2] % アイコン画像名, タイトル文字列
{
    \begin{tcolorbox}[colframe=white ,sidebyside, lower separated=false, lefthand width=1.6cm, arc=5mm]
        \center
        \includegraphics[width=1.6cm]{#1}\\
        \bf #2
        \tcblower
}
{
    \end{tcolorbox}
}

% ".. caution::"の対応。sphinx.styのsphinxadmonitionの中から呼び出されるマクロを上書きしている
\renewenvironment{sphinxcaution}[1]
{\begin{sphinxadmonition_helper}{Caution.png}{#1}}{\end{sphinxadmonition_helper}}

% ".. danger::"の対応。
\renewenvironment{sphinxdanger}[1]
{\begin{sphinxadmonition_helper}{Danger.png}{#1}}{\end{sphinxadmonition_helper}}

        .
        .
        .

最小限データーベースその3

Thu, 25 May 2017 00:00:00 +0900

最小限データーベースその3

コピペとDrag&Dropのデータタイプを増やす。

今までは、自分自身が作成した、データタイプ “com.mindto01s.M3XNote” しかコピペもDrag&Dropも出来なかった。

そのため、newコマンドで項目ノートを作成してから、TextViewへデータをペーストしていた。

これを、Pasteboard に、以下のデータタイプがある場合は、ペーストコマンドで自動で項目ノートの作成とそのノートへのペーストを一手間でできるようにした。

Dropの受け入れ

[M3XViewController viewDidLoad] で [M3XNote pasteBoardRowsType]を[M3XNote pasteBoardRowsTypes]とするだけ。

[self.browserView registerForDraggedTypes:[M3XNote pasteBoardRowsTypes]];

[M3XNote pasteBoardRowsTypes]の方では、以下のように受け入れ可能なUTIを列挙している。

+ (NSArray<NSString*>*) pasteBoardRowsTypes
{
    return @[
             [self pasteBoardRowsType],
             NSPasteboardTypeRTFD,
             NSPasteboardTypeRTF,
             NSPasteboardTypeString,
             NSPasteboardTypePNG, // <-- 入力のみ
             NSPasteboardTypeTIFF,  // <-- 入力のみ
             ];
}

この変更だけで、Dropはは可能になる。もちろんDropした後のコードは何も書いていないので、Dropした瞬間に落ちるはず。

ペーストボードへの書き込み

この変更は、[M3XNote wreiteToPasteboard:]の中だけ。

ペーストボードには複数のデータタイプを入れられるので、今までのコードの末尾に、書き出したいデータのコードを書き足すだけ。

- (void) wreiteToPasteboard:(NSPasteboard*)pasteboard
{
    .
    .
    .

    // 以下から書き足したコード
    NSAttributedString* theAttributedString = [[NSAttributedString alloc] initWithRTFD:self.memo documentAttributes:nil];

    [pasteboard setData:[theAttributedString RTFDFromRange:NSMakeRange(0, theAttributedString.length)
                                        documentAttributes:@{}]
                forType:NSPasteboardTypeRTFD];

    [pasteboard setData:[theAttributedString RTFFromRange:NSMakeRange(0, theAttributedString.length)
                                       documentAttributes:@{}]
                forType:NSPasteboardTypeRTF];

    [pasteboard setString:theAttributedString.string
                  forType:NSPasteboardTypeString];
}

ペーストボードに対してsetData:forTypeなどで書き出している。

ここまでのコードを書くと、このアプリの項目ノートを他のテキストエディターなどペースト出来るようになる。

ペーストボードからの読み出し

読み出しのコードはかなり汚い。

上から順番に、欲しいデータが存在したら処理をしている。独自データが最優先で、次にRTFDなどの文字列系が続き、最後は画像データの順番になっている。

RTFDなどの文字列系は以下のように単純に、NSData型に変換してCoreDataに入れているだけ。

+ (instancetype) readFromPasteboard:(NSPasteboard*)pasteboard
             inManagedObjectContext:(NSManagedObjectContext *)context
{
    M3XNote* theResult = nil;

    .
    .
    .
    // RTFD
    NSData* theRTFD = [pasteboard dataForType:NSPasteboardTypeRTFD];

    if( theRTFD != nil )
    {
        theResult = [NSEntityDescription insertNewObjectForEntityForName:@"M3XNote"
                                                  inManagedObjectContext:context];

        theResult.memo = theRTFD;
        theResult.isHome = NO;

        return theResult;
    }
    .
    .
    .
}

最後の画像系のデータだけ少しだけ複雑なことを行なっている。

NSTextViewはRTFDのデータを表示する機能はあるが、NSImageViewのように直接Imageを設定はできない。そのため、NSTextAttachmentを使用して、画像を貼り付ける形になる。

+ (instancetype) readFromPasteboard:(NSPasteboard*)pasteboard
             inManagedObjectContext:(NSManagedObjectContext *)context
{
    M3XNote* theResult = nil;

    .
    .
    .
    // PNG or TIFF
    NSData* theImageData;
    theImageData = [pasteboard dataForType:NSPasteboardTypePNG];
    if( theImageData == nil )
    {
        theImageData = [pasteboard dataForType:NSPasteboardTypeTIFF];
    }

    if( theImageData != nil )
    {
        theResult = [NSEntityDescription insertNewObjectForEntityForName:@"M3XNote"
                                                  inManagedObjectContext:context];

        NSDateFormatter* theDateFormatter = [[NSDateFormatter alloc] init];
        [theDateFormatter setDateFormat:@"yy/MM/dd H:mm:ss"];

        NSString* theMemoString = [NSString stringWithFormat:@"画像 : %@\n", [theDateFormatter stringFromDate:[NSDate date]]];

        NSMutableAttributedString* theAttributedString = [[NSMutableAttributedString alloc] initWithString:theMemoString];

        NSTextAttachment* theAttachment = [[NSTextAttachment alloc] init];
        theAttachment.image = [[NSImage alloc] initWithData:theImageData];
        NSAttributedString* theAttatchText = [NSAttributedString attributedStringWithAttachment:theAttachment];

        [theAttributedString appendAttributedString:theAttatchText];

        theResult.memo = [theAttributedString RTFDFromRange:NSMakeRange(0, theAttributedString.length)
                                         documentAttributes:@{}];
        theResult.isHome = NO;

        return theResult;
    }
    .
    .
    .
}

ここまで出来れば、他のアプリからこのアプリへコピー＆ペーストが出来るようになる。

今後の課題

実装していないものとして、URLとhtmlのデータタイプがある。これがないために、SafariからURLのDrag&Dropで項目ノートを作成することは出来ない。

これは、現在のアプリのデータ構造の持ち方では、サーバーからデータを取得する時に、メインスレッドをブロックする必要がありそうなので、実装しなかった。

同じく、ファイルDropも実装しなかった。画像ファイルやRTFDファイルをDrop可能にしようかとも考えたが、サイズの大きいデータを考慮していない設計なのでこれも実装しなかった。

今回はここまで。多分続きはなし。( microMemex3.zip )

なんか、code-blockが上手く働いてくれないなぁ。でも、眠いから寝る。

落穂拾い 2017/05/25

Thu, 25 May 2017 00:00:00 +0900

落穂拾い 2017/05/25

日本語ドキュメント - Apple Developer

日本語訳更新

スラド: アップル

最小限データーベースその2

Sun, 21 May 2017 00:00:00 +0900

最小限データーベースその2

前回に課題として残っていた機能を実装する。

コピー＆ペーストを実装し忘れていた問題
最上位のカラムへDropできない問題
Drag&Drop時のドリルダウンアニメーションに、TextViewが追随しない問題

上記の3件の実装は前回のコードに少しだけ追加の記述をすることで実装出来た。変更があるのは、M3XViewControllerクラスだけ。

なお、以下の2件は、NSBrowserのサブクラス化が必要になりそうなので、今回はパス。

TrashCanへのDropで削除できない問題
NSBrowser の focus ring が適切に表示されない問題

コピー＆ペーストの実装

コピペのコードは、Drag&Dropのコードの流用をしています。

そもそも、Drag&Dropは派手なコピー＆ペーストなのでコード自体は同じようなものになります。

コピペメニューの実行

cutを実行するコードは以下の通り。

コピーして削除している。deleteは実装済みなので、copyさえ出来ればこのコードで動く。

- (IBAction) cut:(id)sender
{
    [self copy:sender];
    [self delete:sender];
}

copyを実行するコードは以下の通り。

選択箇所を取得して、pasteboardに書き込むだけ。Drag&DropのコードのDrag開始のコードとほぼ同じ。

異なるのは、書き込むpasteboardがドラッグ用からクリップボード用のgeneralPasteboardに変わっただけ。

- (IBAction) copy:(id)sender
{
    NSIndexPath* theSelectedPath = self.browserView.selectionIndexPath;

    // 選択されているitemの取得
    M3XNote* theSelectedNote       = [[self rootItemForBrowser:self.browserView]
                                      noteFromIndexPath:theSelectedPath];

    // ペーストボードへ書き込み
    [theSelectedNote wreiteToPasteboard:[NSPasteboard generalPasteboard]];
}

pasteを実行するコードも簡単。Dropするコードとほぼ同じ。

pasteboardの変更もcopyメソッドの変更と同じ。

 - (IBAction) paste:(id)sender
 {
     NSIndexPath* theSelectedPath = self.browserView.selectionIndexPath;

     // 選択されているitemの取得
     M3XNote* theSelectedNote = [[self rootItemForBrowser:self.browserView]
                                 noteFromIndexPath:theSelectedPath];

    // ここでCoreDataに追加する
    M3XNote* theNoteFormPasteboard = [M3XNote readFromPasteboard:[NSPasteboard generalPasteboard]
                                          inManagedObjectContext:self.managedObjectContext];

    [theSelectedNote addLinksObject:theNoteFormPasteboard];
}

前回の資料を参考にすれば特に難しいところはないはず。

メニューのenable/disableの制御機構

validateUserInterfaceItemについては過去に何度も書いているので検索してください。

コードを簡潔に表記できるように、「メソッド名の合成」を積極的に使用したコードにしています。

このvalidateUserInterfaceItem部分は、わかりにくいので、2013年頃の記事を参考に色々と悩んでいただけると嬉しい。

cutを許可するコード。単純に選択されていればcutできるようにしています。

- (BOOL) canCut:(nullable id<NSValidatedUserInterfaceItem>)item
{
    return self.browserView.selectionIndexPath != nil;;
}

copyを許可するコード。これも単純に選択されていればcutできるようにしています。

- (BOOL) canCopy:(nullable id<NSValidatedUserInterfaceItem>)item
{
    return self.browserView.selectionIndexPath != nil;;
}

pasteを許可するコード。クリップボードの中のデータをチェックしています。記憶が曖昧ですが、NSDataに変更する前に、どの型が入っているかをチェックするメソッドがあった気がします。ですので以下のコードは動きますが、よくないコードのはずです。

- (BOOL) canPaste:(nullable id<NSValidatedUserInterfaceItem>)item
{
    NSIndexPath* theSelectedPath = self.browserView.selectionIndexPath;

    // 選択されているitemの取得
    M3XNote* theSelectedNote       = [[self rootItemForBrowser:self.browserView]
                                      noteFromIndexPath:theSelectedPath];

    // もう少しスマートな書き方があるはず
    NSPasteboard*   thePasteboard = [NSPasteboard generalPasteboard];
    NSData*         theData = [thePasteboard dataForType:[M3XNote pasteBoardRowsType]];

    return (theSelectedNote != nil) && (theData != nil);
}

コピペの実装はこんな感じ。勉強会で説明したように、コピペのコードは非常に簡単です。

最上位のカラムへDropできない問題への対処

2つのメソッドの修正になる。

Dropを許可するメソッド、browser:validateDrop:proposedRow:column:dropOperation: と、

Drop後にデータを変更するメソッド browser:acceptDrop:atRow:column:dropOperation: の2つ。

必要な情報は、以下の3つ。

最上位のカラムへDropとは、項目(row)がない部分のcolumへのDrop。NSBrowserDropOperationがNSBrowserDropAboveのものを扱うことになる。
NSBrowserDropOnは項目の上、NSBrowserDropAboveは項目と項目の間を意味している。
rowが-1の時にcolumn全体を意味する。

すると、以下のようなコードになる。

NSBrowserDropAboveであれば、Dropはカラム全体へのDropと見なすようにする。

// Drop先
- (NSDragOperation)browser:(NSBrowser *)browser
              validateDrop:(id <NSDraggingInfo>)info
               proposedRow:(NSInteger *)row
                    column:(NSInteger *)column
             dropOperation:(NSBrowserDropOperation *)dropOperation
{
    // item間やitem以外の場所へのDropはカラム全体へのDropと見なす
    if( *dropOperation == NSBrowserDropAbove ) //<---追加した部分の開始
    {
        *row = -1;
        *dropOperation = NSBrowserDropOn;
    }                                          //<---追加した部分の終了

    if( *dropOperation == NSBrowserDropOn )
    {
        // NSDraggingInfoから
        if( info.draggingSource == self.browserView )
        {
            return NSDragOperationLink;
        }
        else
        {
            return NSDragOperationCopy;
        }
    }

    return NSDragOperationNone;
}

Drop後の処理は先ほどのDrop前の処理がわかれば簡単で、row == -1でリンクを貼るノードを変えるだけ。

// Drop後の処理
- (BOOL)  browser:(NSBrowser *)browser
       acceptDrop:(id <NSDraggingInfo>)info
            atRow:(NSInteger)row
           column:(NSInteger)column
    dropOperation:(NSBrowserDropOperation)dropOperation
{
    // まず、Drop先のNoteを求める。
    // pasteboardにデータをNoteのObjectID入れること
    M3XNote* theParentNote =  [self.browserView itemAtIndexPath:
                               [self.browserView indexPathForColumn:column]];

    M3XNote* theDropNote;

    if( row == -1 )// カラム全体
    {
        theDropNote = theParentNote;
    }
    else
    {
        // Dragできるのは一つだけ
        theDropNote = theParentNote.sortedLinks[row];
    }

    // ここでCoreDataに追加する
    M3XNote* theDraggedNote = [M3XNote readFromPasteboard:info.draggingPasteboard
                                   inManagedObjectContext:self.managedObjectContext];

    [theDropNote addLinksObject:theDraggedNote];

    return YES;
}

Drag&Drop時のドリルダウンアニメーションに、TextViewが追随しない問題

これは正しい解決方法かは不明だが、動く。

// Drag&DrilDown時にDrop先のTextViewへ内容へ変更する小細工
- (void)browser:(NSBrowser *)browser didChangeLastColumn:(NSInteger)oldLastColumn toColumn:(NSInteger)column
{
    self.selectedNode = [[self rootItemForBrowser:
                          self.browserView] noteFromIndexPath:self.browserView.selectionIndexPath];
}

lastColumnが変更されれる時に、self.selectedNodeを更新している。

self.selectedNodeの更新に合わせて、TextViewの内容が変更されるので動く。

また、Drag処理が終わると、NSBrowserのselectionIndexPathが復帰するので、そこそこうまく動いているように見える。

今回はここまで。( microMemex2.zip )

「ヴォイニッチの書棚」のバックナンバーの取得

Fri, 19 May 2017 00:00:00 +0900

「ヴォイニッチの書棚」のバックナンバーの取得

もう随分前に番組は終了したのですが、「ヴォイニッチの書棚」というpodcastが好きでした。長時間の移動時によく聞いてました。

また聴きたくなったので、iTunesの中を探したが最後の20回分しか出てこない。

クリラジのサーバーには音源があるようなので、ちょいとxmlを吐く使い捨てコードを書いてみた。

使い方。

ソースを実行するとクリップボードに、xmlを書き込む動作をする。

以下のように、適当なファイルにペーストする。

pbpaste > voi-book.xml

出来上がったファイルを適当なサーバーにアップする。

適当にアップロードする。

itpcスキームでURLを叩いてitunesに取り込む

以下のようにitunesに投げる。
open itpc://アップしたドメイン名/適当なパス/voi-book.xml

以下の場所に生成したvoi-book.xmlをアップしたので使えるかも。

voi-book.xml

ソースコードは、 backNumber-voi.zip

以下の呼び出しで、itunesが起動するかもしれません。自分の分はダウンロードが終わったので試してません。
open itpc://www.mindto01s.com/_downloads/voi-book.xml

作ってみての感想

Objective-Cで書いたのだが、スクリプト言語で書くべきだったな。

スクリプト言語は知らないけど。

Mosa勉強会用資料最小限データベースの作成

Mon, 15 May 2017 00:00:00 +0900

Mosa勉強会用資料最小限データベースの作成

使用言語はswiftでない。
プラットフォームはiOSでない。
特定のテクノロジー(CoreAnimation等)のフォーカスしていない。
なんらかのハウツー物ではない。
チュートリアルでもない。

興味がある物を、調べ、作り、公開するだけです。

( microMemex.zip )

TikZ Sphinx Extensionを導入のメモ

Sun, 07 May 2017 00:00:00 +0900

TikZ Sphinx Extensionを導入のメモ

https://bitbucket.org/philexander/tikz

conf.pyに以下を追加。

extensions = ['sphinxcontrib.tikz']

tikz_proc_suite = 'ImageMagick'

html出力時は上記の2項目で十分だった。pdf出力をする時にエラーになったので、latex_elementsに追記。

latex_elements = {
'passoptionstopackages': r'\PassOptionsToPackage{table}{xcolor} \PassOptionsToPackage{dvipdfmx}{hyperref} \PassOptionsToPackage{dvipdfmx}{graphicx} \PassOptionsToPackage{dvipdfmx}{xcolor}',

dvipdfmxの読み込み時に渡すオプションが足らないようなので、graphicxとxcolorの2つを渡すように変更した。hyperrefなどは以前のポストで話題にした目次を表示させるため。xcolorは表のシマシマ表示用。

.. tikz:: tikzで描いた図

   \draw[thick,rounded corners=8pt]
   (0,0)--(0,2)--(1,3.25)--(2,2)--(2,0)--(0,2)--(2,2)--(0,0)--(2,0);

と書くと、

と表示される。

現状の個人の環境での問題点。

手元の環境では、tinkerで使用できない。理由は多分MacPortsの管理下(/opt/)にないから。

pythonのインストールの流儀がわからないので、pipで入れたコマンドが何処にあるかがわからないのでパスも通せない。

落穂拾い 2017/05/05

Fri, 05 May 2017 00:00:00 +0900

落穂拾い 2017/05/05

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS) マイナーチェンジ

テクニカルノートとQA

In-App Purchase Best Practices (iOS|macOS) マイナーチェンジ

News and Updates - Apple Developer

sphinxでの控えめな表 2

Thu, 04 May 2017 00:00:00 +0900

sphinxでの控えめな表 2

前回の続き。pdf出力の表の表示を変更する。

pdfの場合

conf.pyの変更とlatex用にcustom.styを作る。

この表が

この表のようになる。

薄い枠線。シマシマ表示。ヘッダは少し濃い色でボールド体。多分印刷するとそこそこ見やすいようにした(つもり)。

(1) custom.styの作成

色々とググったり、実験してみたところ、以下のような感じになった。

% 使用パッケージ
\usepackage[table]{xcolor}
\usepackage{etoolbox}

% 使用する色の定義
\definecolor{headerColor}{RGB}{192, 192, 192}
\definecolor{oddColor}{RGB}{240, 240, 240}

% tabular環境の開始と終了をホンノリ書き換える
\let\oldtabular\tabular
\let\endoldtabular\endtabular

% 2行目からシマシマ表示を開始する。
\renewenvironment{tabular}{\rowcolors{2}{oddColor}{}\oldtabular}{\endoldtabular}

% sphinxstyletheadを再定義してヘッダー行に色をつける
\renewcommand{\sphinxstylethead}{\cellcolor{headerColor}\small\textbf}

\arrayrulecolor{oddColor} % 罫線も薄くするといい感じになる

配置場所は”source/custom.sty”。conf.pyの”latex_additional_files”でファイルパスを指定できる。

latexは詳しく無いので、コメントに書いている以上のことはわからない。

(2) conf.pyの変更

公式サイトの以下の記事を参考に、conf.pyのを変更。

latex_elements = {
    # 1. xcolorの方は、rowcolorsを使いたいため
    # 2. hyperrefの方は、pdfの目次を作るため
    'passoptionstopackages': r'\PassOptionsToPackage{table}{xcolor} \PassOptionsToPackage{dvipdfmx}{hyperref}',

    # 同じディレクトリにあるcustum.styを読み込む。app.add_latex_package('custom')は使えないようだ。
    'preamble': r'\usepackage{custom}',
}

# preambleに長々と書きたく無いので、custom.styへ外出ししたものを読み込むようにする。
latex_additional_files = ['custom.sty']

latexもpythonも詳しく無いので、コメントに書いている以上のことはわからない。

pythonの文字列リテラル表現で改行も含めて表記できる方法があった気がしたが、忘れた。

忘れたので、custom.styをファイルとして外に出したが、結果的にこれが正解の気がする。

( spxTblPdf.zip )

sphinxでの控えめな表 1

Wed, 03 May 2017 00:00:00 +0900

sphinxでの控えめな表 1

表の表現が強烈すぎる。もう少し控えめな罫線にしたいし、行毎に背景色を変えて見やすくしたい。

htmlの場合

htmlの場合は簡単。cssを上書きする。

この表が

この表のようになる。

(1) custom.cssの作成

出力されたhtmlを見ると、クラス”row-odd”と”row-even”が適宜されていたので、以下のように奇数行とヘッダ行にだけ色をつけるようにした。

/* 表の奇数偶数で色を分けて見やすくする   */
table.docutils th.head{
    background-color: #eeeeee;
}

table.docutils tr.row-odd{
    background-color: #fafafa;
}

/* 表の枠線の色を薄くして、うるさくないように変更   */
table.docutils td, table.docutils th {
    border: solid #eee;
    border-width: 1px 0.01px 0.01px 1px;
    padding: 0.25em 0.7em;
}

ついでに、枠線の色も薄くした。枠線のの定義で、”0.01px”となっているのは、”0px”にすると別の定義が有効になってしまうようなので、できる限り細くする事で対処した。

custom.cssの配置場所はデフォルトでは”_static/custom.css”。

(2) conf.pyの変更

公式サイトの以下の記事を参考に、conf.pyの末尾に追加。

HTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したい

# HTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したい
# http://sphinx-users.jp/reverse-dict/html/custom-css-js.html
def setup(app):
    app.add_stylesheet('custom.css')

落穂拾い 2017/04/30

Sun, 30 Apr 2017 00:00:00 +0900

落穂拾い 2017/04/30

Apple Developer Center

ガイド

Advertising Guide for News Publishers (iAd System JS|iAd Producer|iOS) アップデート
Apple News API Reference (iOS) マイナーチェンジ
Apple News Format Reference (iOS) マイナーチェンジ
Payment Token Format Reference (iOS) マイナーチェンジ
Search Ads API Reference (iAd System JS|iAd Producer|iOS) マイナーチェンジ

サンプルコード

AlignmentGuides: AppKit Haptic Feedback Filtering using NSAlignmentFeedbackFilter (macOS) マイナーチェンジ
TableViewPlayground: Using View-Based NSTableView and NSOutlineView (macOS) アップデート
User Interface 3D Transforms (iOS) 初版
ZoomingPDFViewer (iOS) アップデート

テクニカルノートとQA

Basic debugging using logging for Swift and Objective-C apps. (iOS|Xcode Developer Tools|macOS) マイナーチェンジ
Checking the availability of iCloud Drive (watchOS|tvOS|iOS|macOS) 初版
Debugging FairPlay Streaming (tvOS|Safari|iOS|macOS) 初版
Hey Siri, How Can I Improve the Recognition of My App’s Name? (iOS) 初版
In-App Purchase Product Identifiers (iOS) アップデート
Reducing the size of my App (watchOS|tvOS|iOS) マイナーチェンジ
Resolving Compatibility Problems on New OS Releases (watchOS|tvOS|iOS|Xcode Developer Tools|macOS) 初版
Sending SMS Programmatically (iOS) 初版
Understanding and Analyzing Application Crash Reports (Xcode Developer Tools) マイナーチェンジ

リリースノート

Xcode Release Notes (Xcode Developer Tools) マイナーチェンジ

落穂拾い 2017/04/29

Sat, 29 Apr 2017 00:00:00 +0900

落穂拾い 2017/04/29

News and Updates - Apple Developer

キーボードショートカットとメニュー選択を記述する

Sun, 23 Apr 2017 00:00:00 +0900

キーボードショートカットとメニュー選択を記述する

ソフトウェアの操作マニュアルやチートシート作成が楽になりそうな記述方法を見つけた。

キーボードショートカットを示す記述と、メニュー選択を示す記述方法。

キーボードショートカットでは、以下の記述をする。

アプリケーションを終了するキーボードショートカットは :kbd:`Command + Q` です。

表示は以下のようになる。

アプリケーションを終了するキーボードショートカットは Command + Q です。

「Command + Q」の部分に淡い色がつく。同じ文書中に繰り返しこの表記が使われる事で読者は地の文とキーボードショートカットの区別を認識しやすくなる効果がある。

同じく、メニュー選択では、以下の記述をする。

アプリケーションを終了するメニューは :menuselection:`File --> Quit` です。

表示は以下のようになる。

アプリケーションを終了するメニューは File ‣ Quit です。

こちらは、より効果的に見える。「File」と「QUit」が地の文とスタイルが異なる事と単語間の三角形がメニュー操作であることを読者に認識させる効果がある。

さらに、csvテーブルの中でも使用可能。以下のようにcsvの中にそのまま書き込める。

.. csv-table:: チートシート見たいな一覧表
    :widths: 25, 75

    "アプリの終了色々", :kbd:`Command + Q`
    "アプリの終了", :menuselection:`File --> Quit`

出力は以下のようになる。tableの細かなレイアウトはテーマファイルなり、styファイルなりを変更すれば好みの物になりそう。

チートシート見たいな一覧表
アプリの終了色々	Command + Q
アプリの終了	File ‣ Quit

余談ですが、操作マニュアルの巻末にメニューやショートカットの一覧があると便利だと思うんです。操作を覚えるまでは、一覧表を見ながら操作すると上達が早くなるからです。

Uncrustifyの設定メモ

Sat, 22 Apr 2017 00:00:00 +0900

Uncrustifyの設定メモ

参考までにUncrustifyの設定ファイルを置いときます。

defaultからの変更は、以下の3つ。

Objective-Cの最低限の対応
bsd/allmanスタイルのindent
変数のアライメントの揃え

( uncrustify.cfg.zip )

DoxygenとXCodeのコメント機能のメモ

Thu, 20 Apr 2017 00:00:00 +0900

DoxygenとXCodeのコメント機能のメモ

1行あけて記述すると詳細な説明のコメント部分になる、javadoc形式のautobriefを使うとコメントが描きやすい。

JAVADOC_AUTOBRIEF      = YES

デフォルトだと、プライベートな実装までドキュメント化されてしまうので、ヘッダファイルだけコメント摘出したほうが良い。

FILE_PATTERNS          = *.h

Xcodeでは、主な構文の前で、”command + option + /”のショートカットキーでコメントの雛形が挿入される。

例:class

雛形の挿入をサポートしている。

/**
 クラスの概要

 1行あけてから、クラスの主な機能をかく。
 - 何の動作に責任を持つか？
 - 実行時に協調するクラスはどれか？
  */
@interface DXWBAppDelegate : NSObject <NSApplicationDelegate>

@end

なお、ObjCでは”-“などのmarkDown構文はXCodeのQuickHelpではサポートされていない。doxygenだとサポートされている。

例:method

雛形の挿入をサポートしている。

/**
 引数inRangeで示す文字列範囲の描画座標を矩形NSRectを返す

 @param inRange 指定する文字列の範囲
 @return 文字列の描画範囲

 ここに詳細な説明を入れる。
*/
- (NSRect) rectForCharacterRange:(NSRange)inRange;

例:property

雛形の挿入をサポートしている。

/**
 Textの描画領域とboundsの差の値
 */
@property (readonly) NSSize interSpacing;

空白行に続けて詳細は書ける。しかし、propertyに詳細な説明が必要な場合は設計が間違っている可能性があるので見直したほうが良い。

例:enum

雛形の挿入をサポートしていない。列挙体全体だけでなく、ここの値でも雛形の挿入はサポートされていない。

自前で、コメントをつける必要があるので、以下のコードを参考にする。 “/**”と”///”を使い分けると見た目がキレイになる。

/**
 DXWBAppDelegateに関わるエラー定数。

 ここに詳細な説明を入れる。
 */

enum E_DXWBAppDelegateError
{
    /// 読み込みエラー
    DXWBAppReadInapplicableDocumentTypeError,

    /// 書き出しエラー
    DXWBAppWriteInapplicableDocumentTypeError
};

例:文字列定数

雛形の挿入をサポートしていない。自前で、コメントをつける必要があるので、以下のコードを参考にする。

/**
 NSString定数の宣言
 */
extern NSString* const DXWBAppConstString;

文字列定数に詳細な説明が必要な場合は設計が間違っている可能性があるので見直したほうが良い。

例:マクロ

雛形の挿入をサポートしていない。自前で、コメントをつける必要があるので、以下のコードを参考にする。

/**
 NSApp.delegateへのアクセッサ
 */
#define AppDelegate ((DXWBAppDelegate *)[NSApp delegate])

文字列定数や列挙型をclassと同じグループにまとめる

Objective-Cでは、同じファイルで定義されている文字列定数や列挙型は、同じファイル中のクラスと強く関連づけられています。

それを明示するために、以下のように、”//@{“と”//@}”でくくるとDoxygenでグループ付けしてくれます。

//@{

// マクロ
 .
 .
// クラス定義
 .
 .
// 文字列定数
 .
 .
//@}

( doxygenWorkBench_2.zip )

uncrustifyもういっぱい

Fri, 14 Apr 2017 00:00:00 +0900

uncrustifyもういっぱい

はじめに

以前 uncrustifyおかわりで紹介したように、uncrustifyはObjective-Cに対応したソースコードの整形ツールです。 XCodeからuncrustifyを呼び出すuncrustifierというExtensionが公開されています。

今回は、そのuncrustifierの紹介です。

環境

uncrustifyは、macPortsで構築した。

macosx 10.12.4
xcode 8.3.1
MacPorts 2.4.1
uncrustify 0.64
uncrustifier 1.2

uncrustifierのインストール

ここから https://github.com/yieldmo/uncrustifier/releases バイナリを持ってきて適当な箇所にコピーするのが一番簡単。

ソースコードからビルドする場合は、https://github.com/yieldmo/uncrustifier でコードを持ってくる。

インストール自体は、ビルド後に出来上がったアプリケーションを立ち上げると自動でインストールされる。

uncrustifierの設定

uncrustifierアプリを立ち上げて、スタイルを選ぶ。

Windowが1つだけのアプリでここでスタイルが設定できる。

“システム環境設定” > “機能拡張” > “Xcode Source Editor” でuncrustifyにチェックを入れて有効にする。

Note

Resources以下のファイルを書き換えると、デフォルトの設定を変更できるとの公式サイトに載っている。しかし、uncrustifierの設定の設定画面で、PopupMenuから”Custom File…”を選べばappexのリソースを直接変更するような事をしなくても変更できる。ただし、設定ファイルの内容を変更するたびに読み込ませる必要がある。

XCodeからの使い方

メニューからの呼び出し方は、 “Editor” > “uncrustify” > “Format Current Document” で呼び出せる。編集中のドキュメントを対象に整形する。

ショートカットキーは、各自が適当につける。設定方法は、”XCode” > “Prefarences…” > “Key Bindings”の画面で行う。

“uncrustify”でフィルターすると対象のメニューが出るのでお好みのショートカットをつけると良い。

参考文献

uncrustify公式サイト: http://uncrustify.sourceforge.net/
uncrustifier公式サイト: https://github.com/yieldmo/uncrustifier
オプションの日本語解説: http://www.6809.net/tenk/?PG雑記%2fUncrustifyのオプション http://qiita.com/ayakix/items/3f05da9541b8e130e39f
設定ファイルの例: https://github.com/tonyarnold/energon/blob/master/uncrustify.cfg https://gist.github.com/954967
以前の記事: http://www.mindto01s.com/2013/01/24/recipe_uncrustify.html

Doxygenの設定メモの続き

Thu, 13 Apr 2017 00:00:00 +0900

Doxygenの設定メモの続き

参考にしたサイトでは自動化にsedを使っていたが、私にはsedの文法が分からない。 diffとpatchで対応することにした。

doxygen出力ディレクトリ

出力ディレクトリは、以下を前提としています。

OUTPUT_DIRECTORY       = "build/doxygen"

patchファイル

以下のzipファイルの”doxygen-latex.patch”にパッチファイルを用意した。

( doxygenWorkBench.zip )

コマンド実行

パッチの適応と、pdfの作成。

$ doxygen
$ patch -p0 < doxygen-latex.patch
$ cd build/doxygen/latex
$ make pdf

あとは、適当にソースのビルド時に上記のスクリプトを追加すれば良さそう。

Doxygenの設定メモ

Tue, 11 Apr 2017 00:00:00 +0900

Doxygenの設定メモ

今までpdf出力は文字化けがするので諦めていた。以下のサイトを参考に色々と試したら、文字化けが治ったしフォントも綺麗になった。

残念ながら、今はもう紙の関数仕様書を要求する仕事は無いし、おそらくこれからも無いので単純に趣味の世界です。

で、作業メモ。

環境

環境は、macPortsで構築した。

macosx 10.12.4
xcode 8.3.1
MacPorts 2.4.1
TeX Live 2016/MacPorts 2016_4
doxygen 1.8.13

構築したと言っても以下の1行を入力しただけ。

$ sudo port install texlive +full

Doxyfileファイルの設定

最低限、以下の3項目を変更すれば良い。

OUTPUT_LANGUAGE = English
LATEX_CMD_NAME  = latex
USE_PDFLATEX    = YES

これらの項目を以下のように変える。

OUTPUT_LANGUAGE = Japanese
LATEX_CMD_NAME  = uplatex
USE_PDFLATEX    = NO

それぞれの意味は、参考にしたサイトに載っているので特にここでは書かない。

ソースコードの位置や出力ファイルの位置も各自に合わせること。

最初の出力

一度、doxygenコマンドを実行して、latexディレクトリを生成する。

生成されたmakeファイルを実行すると文字化けのするpsファイルやpdfファイルしか作成できない。

その壊れたlatexディレクトリ中のmakeファイルを修正する。

修正箇所は3箇所。

1. pdfの生成にはdvipdfmxを使う

PostScriptファイルから生成している箇所をdvipdfmxから生成するように変更するだけです。

以下の箇所を変更します。

refman.pdf: refman.ps
       ps2pdf refman.ps refman.pdf

変更後は以下のようになります。

refman.pdf: refman.dvi
       dvipdfmx refman.dvi

2. pdfの複数のページを1ページにまとめるにはpdfnupを使う

ps2pdfはうまく日本語が通らないようなので、pdfnupを使います。

以下の箇所を変更します。

refman_2on1.pdf: refman_2on1.ps
       ps2pdf refman_2on1.ps refman_2on1.pdf

変更後は以下のようになります。

refman_2on1.pdf: refman.pdf
       pdfnup refman.pdf
       mv refman-nup.pdf refman_2on1.pdf

3. 複数のpdfをまとめたファイルの後片付けをする

おそらく、doxygenの記載漏れ。clean時にrefman_2on1.pdfも含めるだけ。

以下の箇所を変更します。

clean:
       rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf

変更後は以下のようになります。

clean:
       rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf refman_2on1.pdf

pdfに目次を作る

ここまでの変更を行うとpdfの文字化けは治ります。ここから先は、大抵の人には関係ありません。

印刷時の目次はあります。ここで作る目次は、pdfのbookmarkと呼ばれる機能です。

リンクの色は黒。bookmarkはdvipdfmxに対応させる。

% Hyperlinks (required, but should be loaded last)
\usepackage{ifpdf}
\ifpdf
  \usepackage[pdftex,pagebackref=true]{hyperref}
\else
  \usepackage[ps2pdf,pagebackref=true]{hyperref}
\fi
\hypersetup{%
  colorlinks=true,%
  linkcolor=blue,%
  citecolor=blue,%
  unicode%
}

上記のコードを以下に置き換え。

% Hyperlinks (required, but should be loaded last)
% hyperrefをdvipdffmx用に決め打ち
\usepackage[dvipdfmx,
            pagebackref=true,
            colorlinks=true,
            linkcolor=darkgray,
            urlcolor=darkgray,
            bookmarks
           ]{hyperref}
\usepackage{pxjahyper} % 日本語で'しおり'したい

これで、目次も出来て、リンクも作成された。

見た目を整える

完全に趣味です。

本文を明朝体にして、章立てやラベルはゴシック体に変更する。

% Custom commandsの末尾にでも以下のコードを追加する。

\usepackage[uplatex,deluxe, expert]{otf}

% sectionの書体を"ゴシック体、サンセリフ体、太字"
\allsectionsfont{
\gtfamily\sffamily
\color{darkgray}
}

% labelの書体を"ゴシック体、サンセリフ体、太字"
\renewcommand{\DoxyLabelFont}{
\gtfamily\sffamily
\color{darkgray}
}

\renewcommand{\kanjifamilydefault}{\mcdefault} % 日本語書体を明朝体
\renewcommand{\familydefault}{\rmdefault} % 欧文書体をローマン体

また、細すぎるので表紙のタイトルはゴシック体のボールドにする。begin{titlepage}の次の行に追加。

\begin{titlepage}
\gtfamily\sffamily\bfseries % <-- これを追加

ヒラギノフォントを使っているかも

macPorts の場合以下のコマンドでヒラギノを有効にした記憶があるが定かでは無い。

$ cd /opt/local/share/texmf-texlive/scripts/cjk-gs-integrate
$ sudo perl cjk-gs-integrate.pl --link-texmf --force
$ sudo mktexlsr
$ sudo kanji-config-updmap-sys hiragino-elcapitan-pron

以下のコマンドではヒラギノが埋め込まれているように見える。

$ pdffonts refman.pdf

参考URL

DoxygenのLaTeX出力で日本語を使う（2015年版） http://dev.activebasic.com/egtra/2015/06/29/814/

次は、上記のサイトのように、スクリプトで自動化したい。

Cocoaからのライブ変換(LiveConversion)の変更と監視

Mon, 27 Mar 2017 00:00:00 +0900

Cocoaからのライブ変換(LiveConversion)の変更と監視

今の所、専用のAPIは見つかっていない。設定ファイルやDistributedNotificationの監視で見つかった事を書く。

変更の監視

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification
{
   [[NSDistributedNotificationCenter defaultCenter]
           addObserver:self
              selector:@selector(jimPreferencesDidChangeNotification:)
                  name:@"com.apple.inputmethod.JIM.PreferencesDidChangeNotification"
               object:nil
    suspensionBehavior:0];
}

- (void) jimPreferencesDidChangeNotification:(NSNotification*)note
{
    NSLog(@"jimPreferencesDidChangeNotification => %@",
          [note.userInfo valueForKey:@"JIMPrefLiveConversionKey"]);
}

現在の設定の確認

NSUserDefaults* theUD = [[NSUserDefaults alloc] initWithSuiteName:@"com.apple.inputmethod.Kotoeri"];

NSLog(@"[theUD valueForKey:JIMPrefLiveConversionKey] => %@",
        [theUD valueForKey:@"JIMPrefLiveConversionKey"]);

Warning

ImputMethodのprefarenceを参照しているだけなので、sandbox環境では正常に動作しない。

ライブ変換を有効/無効にする

有効

[[NSDistributedNotificationCenter defaultCenter] postNotificationName:@"com.apple.inputmethod.JIM.PreferencesDidChangeNotification"
                                                                  object:@"com.apple.JIMSession"
                                                                userInfo:/*@{@"JIMPrefLiveConversionKey" : @(1)}*/ // <--コメントアウトを外して使用すること
                                                                 options:0];
[[NSDistributedNotificationCenter defaultCenter] postNotificationName:@"com.apple.inputmethod.JIM.PreferencesDidChangeNotification"
                                                                  object:@"com.apple.JIMPreferences"
                                                                userInfo:/*@{@"JIMPrefLiveConversionKey" : @(1)}*/ // <--コメントアウトを外して使用すること
                                                                 options:0];

無効

[[NSDistributedNotificationCenter defaultCenter] postNotificationName:@"com.apple.inputmethod.JIM.PreferencesDidChangeNotification"
                                                               object:@"com.apple.JIMSession"
                                                             userInfo:/*@{@"JIMPrefLiveConversionKey" : @(0)}*/ // <--コメントアウトを外して使用すること
                                                              options:0];
[[NSDistributedNotificationCenter defaultCenter] postNotificationName:@"com.apple.inputmethod.JIM.PreferencesDidChangeNotification"
                                                               object:@"com.apple.JIMPreferences"
                                                             userInfo:/*@{@"JIMPrefLiveConversionKey" : @(0)}*/ // <--コメントアウトを外して使用すること
                                                              options:0];

Warning

sandbox環境では、NSDistributedNotificationはuserInfoにデータを渡すことはできない。sandbox環境では動作しない。

以上のコードでライブ変換の監視/変更が出来るが、sandbox環境では正常動作しない。 sandbox環境で動作するのは変更したタイミングの取得だけ。

“HIToolbox/TextInputSources.h”にあるInputSourceの変更が正規のAPIの可能性があると思い、TISCreateInputSourceListで取得できるリストを見たがそれらしきものはなかった。

最小限アウトラインプロセッサの作り方

Sat, 25 Mar 2017 00:00:00 +0900

最小限アウトラインプロセッサの作り方

Cocoa勉強会松戸用の資料。

NSOutlineViewとNSTreeControllerを使って、”Copy&Paste”,”書類の保存と読み込み”,”Drag&Drop”の実装までの最小限アウトラインプロセッサの作り方の資料です。

なお、ソースコードとPDFはここです。

( TreeOutliner_01.zip ) ( 最小限アウトラインプロセッサの作り方.zip )

解説は当日に行います。

pragma markによるメソッドの分類

Thu, 16 Mar 2017 00:00:00 +0900

pragma markによるメソッドの分類

この記事は、pragma markを最初にコピペする事でクラス実装の抜けや漏れを防ぐ方法の紹介です。

コメントと同じく機械側には無くても良いが、プログラマ側に実装すべきメソッドを思い出しやすくします。

最初にpragma mark のリストをコピペする

クラスを作成すると、.hと.mに以下のコードをコピペします。

#pragma mark - class methods

#pragma mark - init methods

#pragma mark - dealloc

#pragma mark - NSCopying, hash, isEqual:

#pragma mark - NSCoding methods

#pragma mark - restorableState methods

#pragma mark - life cycle methods

#pragma mark - action methods

#pragma mark - event handling methods

#pragma mark - drawing methods

#pragma mark - delegate/datasource methods

#pragma mark - accessor methods (in pairs)

#pragma mark - Utility methods

あとは、メソッドを書いてゆくだけです。

メリットは、以下の2点です。

次に書くべきメソッドを思い出しやすい。

人間は穴埋め問題の様に場所が決まっていると、何をすれば良いかが思い出しやすい。

コードのブラウズ時に検索や移動がやりやすい。

メソッドの分類毎に、”mark -“の文字列があるので、”⌘F mark -“と”⌘G”で分類の間を移動できる。

Note

今まで私は”ハイフン”行と”分類名”行で2行に分けて記述していました。しかし、先ほど試した結果1行でも問題なくXCodeが動作しました。ですので、今後は1行で記述するつもりです。

次は、それぞれの分類に何を書いているかの説明です。

pragma mark - class methods

クラスメソッドを書く場所。

[NSDocument autosavesInPlace]などのクラス特有の性質を示すメソッドやインスタントイニシャライザを書く。

例:

+ (BOOL) autosavesInPlace;
+ (NSURL*) fileURLWithPath:(NSString*) path;

pragma mark - init methods

イニシャライザを書く場所。

引数が少ないメソッドを上の方に、引数の多いメソッドをしたの方に書く様に気をつける事。

書くときはすこし手間が増えるが、コードを読むときに流れが上から下になるので分かりやすくなる。

Objective-Cのイニシャライザでは最も引数の多いメソッドが、指定イニシャライザになるので、必然的に上記の様になる。

例:

- (instancetype) init;
- (instancetype) initFileURLWithPath:(NSString *)path;

pragma mark - dealloc

deallocを書く場所。

各種プロパティをnilに戻す事や、KVOの停止、Notificationの受信の停止など。

例:

- (void) dealloc;

pragma mark - NSCopying, hash, isEqual:

オブジェクトのコピーや同一性に関わるメソッドの実装を書く場所。

MVCで言うところのViewクラスやControllerクラスでは必要ありませんが、逆にmodelクラスに相当するクラスの場合は実装はほぼ必須です。

例:

- (id) copyWithZone:(NSZone *)zone;
- (id) mutableCopyWithZone:(NSZone *)zone;
- (BOOL) isEqual:(id)object;
- (NSUInteger) hash;

pragma mark - NSCoding methods

シリアライズ化メソッドを書く場所。

Cut&PasteやDrag&Drop、ファイル保存の実装にはNSCodingのメソッドを使うと簡単になる。

例:

- (void)encodeWithCoder:(NSCoder *)aCoder;
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder;

pragma mark - restorableState methods

状態保存関係のコードを書く場所。

クラスメソッドであるが[NSResponder (NSRestorableState) restorableStateKeyPaths]もここに書く。

例:

+ (NSArray *)restorableStateKeyPaths;
- (void) encodeRestorableStateWithCoder:(NSCoder *)coder;
- (void) restoreStateWithCoder:(NSCoder *)coder;

pragma mark - life cycle methods

オブジェクトのライフサイクルのコードを書く場所。

ViewControllerやWindowControllerのライフサイクルに関するメソッドを書きます。場合によっては、delegateやnotificationに分類される様なメソッドも書きます。

例:

- (void)awakeFromNib;

// windowControllerの場合
- (void)windowWillLoad;
- (void)windowDidLoad;

// ViewControllerの場合
- (void)viewDidLoad;

- (void)viewWillAppear;
- (void)viewDidAppear;
- (void)viewWillDisappear;
- (void)viewDidDisappear;

// NSApplicationDelegateの場合
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification;
- (void)applicationWillTerminate:(NSNotification *)aNotification;

pragma mark - action methods

IBActionのメソッドを書く場所。

ユーザーが実行できるコマンドの単位になる、IBAction系のメソッドを書く。

また、enable/disableを制御するためのcanAction系のメソッドも一緒に書いておくと楽。ライブラリcontrolEnablerを使用すると良い。 validateuserinterfaceitem(7)

例:

- (IBAction) anAction:(id)sender;        // action
- (BOOL)     canAnAction:(id)sender;     // actionを呼出すボタンの有効無効を制御

pragma mark - event handling methods

イベント処理のメソッドをこの場所に書く。

NSResponderのサブクラスでない場合でも、KVOの監視メソッドや、Notificationの受信メソッドをイベント処理と考えて、この場所に書いておくと楽。

例:

// KVOの監視メソッド
- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(id)object
                        change:(NSDictionary *)change
                       context:(void *)context;

// なんらかのnotificationのレシーバー
- (void) nanikanoNotificationNoReciver:(NSNotification *)aNotification;

// キーダウンイベントを処理したり
- (void)keyDown:(NSEvent *)event;

pragma mark - drawing methods

描画系のメソッドを書く場所。

NSViewのサブクラスしか関係ないが、当然まとめておくと楽。

例:

- (void)drawRect:(NSRect)dirtyRect;

pragma mark - delegate/datasource methods

他の分類には分けられない、delegateメソッドやdatsourceメソッドを書く場所。

例:

// NSSpliterViewのdelegate
- (void)splitViewWillResizeSubviews:(NSNotification *)notification;
- (void)splitViewDidResizeSubviews:(NSNotification *)notification;

pragma mark - accessor methods (in pairs)

アクセッサとKVCに関連するものを書く。

依存関係の記述の”keyPathsForValuesAffectingプロパティ名”クラスメソッドもここに書く。インデックス付きアクセッサパターンのメソッドもここにまとめます。

例:

+ (NSSet *)keyPathsForValuesAffectingObject
- (id) object
- (void) setObject:(id)inObject

pragma mark - Utility methods

その他のユーティリティメソッドを書く。例は特になし。

参考文献

元ネタは、ヒレガス本かその前後のはずだがググっても出てこない。

CoreDataプロジェクトでDocument.xcdatamodelの名前を変更するには

Wed, 15 Mar 2017 00:00:00 +0900

CoreDataプロジェクトでDocument.xcdatamodelの名前を変更するには

Document.xcdatamodelの名前を変更するときは注意が必要。

同じディレクトリにあるファイル”.xccurrentversion”の中に、Document.xcdatamodelのファイル名が書き込まれている。

ファイル名を変更する場合は、キー”_XCCurrentVersionName”の値も変更する必要がある。

$ more .xccurrentversion
version="1.0" encoding="UTF-8"?>
"-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
version="1.0">

_XCCurrentVersionName
Document.xcdatamodel  <--- ここ

上記のリストの”Document.xcdatamodel”部分をファイル名と一致させる事。

Cocoaにおける状態の保存と復元その2

Sat, 04 Mar 2017 00:00:00 +0900

Cocoaにおける状態の保存と復元その2

以前に「 Cocoaにおける状態の保存と復元」にて書いた記述が間違っていた。

splitViewの中のviewをrestoreStateWithCoder:のメソッドの中で生成していたがそれはおそらく間違い。

restore stateの機能は、以下の2点を守れば小細工は必要ない。

view階層はrestoreStateWithCoder:が呼ばれる前に構築済みである。
restore sateに参加させるobjectはwindow内でユニークなidentifierが設定されている。

この2点を守るのは、通常のアプリケーションでは問題にならない。

「 Cocoaにおける状態の保存と復元」で書いた様に、NSTabViewのタブやNSSplitViewのsplitが動的に増える場合にのみ問題になる。

この記事での方法上記の2点を守ることでより簡潔に「状態の保存と復元」を実装する。

実装の概要

nibファイルからのWindowの構築が終わり、メソッドrestoreStateWithCoder:が呼ばれる前のタイミングを得る場所は、以下に示す2つのメソッドになる。

- (void)restoreDocumentWindowWithIdentifier:(NSString *)identifier
                                      state:(NSCoder *)state
                          completionHandler:(void (^)(NSWindow *, NSError *))completionHandler;

- (void) makeWindowControllers;

ただし、makeWindowControllersの方は、引数としてNSCoderが渡されないために、動的にViewを構築するための情報が足らない。

よって、restoreDocumentWindowWithIdentifier:〜をオーバーライドすることになる。

通常、restoreDocumentWindowWithIdentifier:〜をオーバーライドする場合は、以下の様なコードになる。

ググっても”通常”のrestoreDocumentWindowWithIdentifierの使用方法はでてこないので私を信じてほしい。

- (void)restoreDocumentWindowWithIdentifier:(NSString *)identifier
                                      state:(NSCoder *)state
                          completionHandler:(void (^)(NSWindow *, NSError *))completionHandler
{
    NSWindowController* theWindowController;

    if( [identifier isEqualToString:@"window_01"] )
    {
        theWindowController = [self makeWindowController_01];
    }
    else if( [identifier isEqualToString:@"window_02"] )
    {
        theWindowController = [self makeWindowController_02];
    }
    .
    .
    .
    else if( [identifier isEqualToString:@"window_nn"] )
    {
        theWindowController = [self makeWindowController_nn];
    }

    completionHandler([theWindowController window], nil);
}

identifierはクラスではない。同じクラスであっても異なる用途であれば異なるidentifierが設定される。主にnibファイルによって設定され、このなるWindowControllerによって制御される。

このメソッドの中での、completionHandlerによって、restoreStateWithCoder:が呼び出される。

引数identifierとcompletionHandlerは使用されるが、引数stateは使用されていない。

引数stateに保存されている値が保存されているのは、[NSWindowController encodeRestorableStateWithCoder:]で保存できる。

状態の保存時に、動的に生成された部分の情報を[NSWindowController encodeRestorableStateWithCoder:]で保存して、[NSDocument restoreDocumentWindowWithIdentifier]で再生すると実現できる。

サンプルコードの実装

状態の保存に関してみるべきメソッドは以下の3つ。

[TVSDocument restoreDocumentWindowWithIdentifier:state:completionHandler:];
[TVSWindowController prebuildForRestorableStateWithWindowCoder:];
[TVSWindowController encodeRestorableStateWithCoder:];

restoreDocumentWindowWithIdentifierと、prebuildForRestorableStateWithWindowCoderは状態の再生時に使用している。

encodeRestorableStateWithCoderは状態の保存時に使用する。

保存再生する値はsplitViewの分割数で、”numOfSplit”と名前をつけている。

restoreDocumentWindowWithIdentifierの関連箇所は以下の様に、WindowzControllerを作成したら、stateを引数にprebuildForRestorableStateWithWindowCoderを呼び出すだけ。

- (void)restoreDocumentWindowWithIdentifier:(NSString *)identifier
                                      state:(NSCoder *)state
                          completionHandler:(void (^)(NSWindow *, NSError *))completionHandler
{
    TVSWindowController* theWindowController;

    theWindowController = (TVSWindowController*)[self makeWindowController];

    // restore state のコードが走り出す前に、View構造を構築する必要がある。
    // そのため、ここで追加のView構造を構築する機会をwindowに与える。
    [theWindowController prebuildForRestorableStateWithWindowCoder:state];

    completionHandler([theWindowController window], nil);
}

引数stateの中に、”numOfSplit”の値が入っている。ので、prebuildForRestorableStateWithWindowCoderではそれを使ってsplitViewへ分割をお願いする。

- (void) prebuildForRestorableStateWithWindowCoder:(NSCoder*)coder
{
    TVSSplitViewController* theSplitViewController = (TVSSplitViewController*) self.contentViewController;

    // restore state のコードが走り出す前に、View構造を構築する必要がある。
    NSInteger theSplitNumber = [[coder decodeObjectForKey:@"numOfSplit"] integerValue];

    [theSplitViewController createPaneWithNumber:theSplitNumber];
}

状態の保存時に関連するのは、encodeRestorableStateWithCoderだけ。restoreStateWithCoderと対になっていないので気持ち悪いが動的なViewの生成に「状態の保存」が対応していないので仕方がない。コードとしては以下の様になっている。

- (void) encodeRestorableStateWithCoder:(NSCoder *)coder
{
    TVSSplitViewController* theSplitViewController = (TVSSplitViewController*) self.contentViewController;

    [super encodeRestorableStateWithCoder:coder];

    [coder encodeObject:[NSNumber numberWithInteger:theSplitViewController.splitViewItems.count]
              forKey:@"numOfSplit"];

    [coder encodeObject:self.indexes forKey:@"indexes"];
}

@”indexes”は選択範囲の保存に関係する箇所。画面分割に関係するのは@”numOfSplit”の箇所です。

なお、画面の分割後のsplitViewの中のviewの記述は特に工夫を要する箇所はない。

スクロール位置の保存と再生も”contentView.bounds”を保存して再生時には、reflectScrolledClipView:を使って画面をリフレッシュしているくらいです。

その他

前回のCocoa勉強会で話題になった、「選択位置の情報はどのオブジェクトが保持するべきか？」の問題ですが、WindowControllerに持たせることにしました。

これで、モデルデータは共通だが、選択位置が異なるWindowが実現できています。

なお、ソースコードはここです。

( TableViewSpliter_2.zip )

storyboardの中のNSWindow initialFirstResponderが効かない問題について (2)

Sun, 26 Feb 2017 00:00:00 +0900

storyboardの中のNSWindow initialFirstResponderが効かない問題について (2)

表題について、最も簡単な方法は、有効にしたいviewControllerのawakeFromNibの中で、initialFirstResponderの設定をする事です。

awakeFromNibが複数回呼ばれる事にさえ気をつければ最も簡単な解決方法になります。

@interface ViewController : NSViewController

@property (weak) IBOutlet NSTextField* textField;

@end

@implementation ViewController

- (void) awakeFromNib
{
    [super awakeFromNib];

    // 汎用性はないが、もっと簡単な方法
    self.view.window.initialFirstResponder = self.textField;
}

@end

この解決法の問題点は、汎用性がない事です。「storyboardの中のNSWindow initialFirstResponderが効かない」のはnibファイル間でoutletが接続できない事が原因です。

ここでは、このnibファイル間でoutlet接続をする方法を解説します。

nibファイルの読み込み時に何が起こっているのか？

まずは前提条件となる知識として、nibファイルの読み込み時に起こっていることを説明します。

nibファイルの読み込み時には以下のようなことがおこります。

非カスタムオブジェクトのアンアーカイブ

フラット化されたストリームからNSKeyedArchiverが作成され、そこから初期化メソッドとしてinitWithCoder:が呼ばれ、それぞれのObjectが生成されます。

カスタムオブジェクトのインスタンス化 (サロゲートObject) cutumViewなど

カスタムViewなどのdecodeされたわけではないviewが、初期化メソッドinitWithFrameが呼ばれて、

オブジェクト間のコネクション関連の設定やRuntimeAttibuteの設定

IBOutletConnectionのサブクラスにestablishConectionメッセージが呼ばれ、コネクションを確立します。

nibから再生された全てのオブジェクトにawakeFromNibを呼び出し

objectの生成もコネクションの確立も完了したのちに、awakeFromNibを呼び出してそれぞれのオブジェクトに追加の初期化処理への機会を与えます。

正確ではないかもしれませんが、以上のような手順でnibから読み込まれます。

Note

なお、ストーリーボードが複数のnibに分割される場合には、3と4の間でまた別のnibを読み込むことがあります。そして、この分割によってoutletが接続できないのです。困ったね。

nibファイル間のoutlet接続の実現のアイデア

outlet接続では、objectを直接outletの変数接続している。これはアーカイブしたときには、objectのハッシュ値になるわけだが、アンアーカイブされたときにobjectのポインター値へ変換される。

同じ、接続(IBConnectors)プロトコルをサポートしているものでも、bindingの様に、ポインターとパスの組み合わせでobjectを指定するものがある。

今回は、このbinding接続の様にパスを使うことで、目的のobjectへ到達できる様にすることを目標にクラスを作成してた。

ただし、現状のIBOutletConnectionのサブクラスを作成してもXCode場では使用できないので、NSObjectのサブクラスを作成することにした。

実際の接続作業は、nibファイル中のobjectが全てインスタンス化した後のawakeFromNibメソッドの中で行う。

要約すると、

起点とするrootとなるobjectへのポインターを設定
起点から接続先を示せるキーパス文字列を設定
Outletが設定されているobjectはポインターで設定
Outletの変数名は、キー名で設定
上記の値を元に、awakeFromNibでコネクションを確立する。
IBOutletConnectionをサブクラス化しない理由は、XCode場で編集できないから

クラスの実装

ヘッダファイルはこんな感じ。

@interface MTLOutletProxy : NSObject

// オブジェクトoutletObjectのアウトレット名outletNameにポインター値を入れる。
@property (weak) IBOutlet      id        outletObject;
@property (copy) IBInspectable NSString* outletName;

// そのポインター値は、objectRootを起点として、キーパスobjectPathで示されるオブジェクトのポインター
@property (weak) IBOutlet      id        objectRoot;
@property (copy) IBInspectable NSString* objectPath;

@end

実装はこれだけ。

@implementation MTLOutletProxy

- (void) awakeFromNib
{
    [self.outletObject setValue:[self.objectRoot valueForKeyPath:self.objectPath]
                     forKeyPath:self.outletName];
}

@end

以上の様に非常にシンプルなクラスになる。

クラスの使用方法

「storyboardの中のNSWindow initialFirstResponderが効かない」の問題を、このクラスを用いて解決する。

ここにMTLOutletProxyを置く

NSObjectを配置して、class名をMTLOutletProxyに変更する。

viewControllerにキーパスでタグれる様にプロパティを作っておき、outlet接続しておく。

コードは以下の通りですが、普通はイニシャルレスポンダーにしたいobjectへはすでにoutletがあるはず。

@interface ViewController : NSViewController

@property (weak) IBOutlet NSTextField* textField_1;
@property (weak) IBOutlet NSTextField* textField_2;
@property (weak) IBOutlet NSTextField* textField_3;
@property (weak) IBOutlet NSTextField* textField_4;//<--今回はこれをイニシャルファーストレスポンダーにする

@end

Windowと接続

MTLOutletProxyのoutletObjectアウトレットに、NSWindowを指定する。

起点としてWindowControllerと接続

MTLOutletProxyのobjectRootアウトレットに、NSWindowControllerを指定する。キーパスの起点になります。

Windowの中のinitialFirstResponderプロパティを指定するために文字列を設定

outlet nameにinitialFirstResponderを入力

WindowControllerからキーパス文字列を設定して、最初にフォーカスが当たるObjectを指定

object pathにcontentViewController.textField_4を入力

実行時に起こること

MTLOutletProxyの以下のメソッドが呼び出される。

- (void) awakeFromNib
{
    [self.outletObject setValue:[self.objectRoot valueForKeyPath:self.objectPath]
                     forKeyPath:self.outletName];
}

先ほどの各種設定をして入れば、

window.initialFirstResponder = windowController.contentViewController.textField_4;

を実行しているのと同じになる。このawakeFromNibの実行時点ではwindowは表示される前なのでinitialFirstResponderの値は有効になり、 textField_4がfirstResponderになる。

ただし、その後”Restore state”の機能が実行されて、2回目以降は前回のfirestResponderへフォーカスが移動してしまう。

Note

デバッグ時にRestore state機能をOffにするには、”Edit scheme…” > “Run” > “Options” > “Persistant State”のチェックボックスをONにする。これを行わないと、最後にWindowを閉じた時のfirstResponderにフォーカスが当たってしまう。

以上で終わりです。じゃあね。

storyboardの中のNSWindow initialFirstResponderが効かない問題について (1)

Sat, 25 Feb 2017 00:00:00 +0900

storyboardの中のNSWindow initialFirstResponderが効かない問題について (1)

MOSA.swiftでMTLProxyResponderを使えば出来ると嘘をついてしまったのでお詫び。

ソースコードだけ。 ( InitalFirstResponderWB.zip )

サンプルコードの動作は、初回起動時だけ、ViewControllerに結び付けられたtextField_4が最初にアクティブになります。

二回め以降は”restore state”が効くので最後に終了した時のfirstResponderになります。

仕組みの解説や応用は、眠いので明日書きます。

じゃあね。

NSTreeControllerで使用するObjectの変換についてのメモ

Tue, 21 Feb 2017 00:00:00 +0900

NSTreeControllerで使用するObjectの変換についてのメモ

NSTreeControllerでnodeを示すのに使用されるObject

NSTreeNode: NSTreeControllerで木構造のノードを管理しやすくするためのクラス。このクラスのインスタンスから、自分自身のNSIndexPathや、NSManagedObjectへの参照を得ることができる。親ノード、小ノードを手繰ることが出来る。
NSIndexPath: ノードの位置を数字の列で指定するクラス。各ノードは、親のオブジェクトのNSArrayに入っている。この、NSArrayのindexの値を複数持つことで、fileSystemのパスのように目的のノードの位置を指定することができる。 2/22追記:選択範囲を”状態の保存”で保存する場合は、このindexPathを使用するのが望ましい。NSTreeNodeやNSManagedObjectは保存ファイルやポインターに依存しているので、識別子の変換作業が追加で必要になる。
NSManagedObject: NSTreeControllerが参照するモデルとしてCoraDateを使用する場合に、ノードのデータ本体としてこのクラスのサブクラスが使用される。NSTreeNodeのrepresentedObjectに設定される。
row: NSTreeControllerがNSTableViewやNSOutlineViewに結び付けられている時に、表示中の0から始まる行番号を示す。表示上の値であるため、兄弟ノードの子ノードが表示の為に開閉されると、子ノード分増減する。

上記のObjectの相互変換

NSTreeNodeから各種Objectへの変換

もっとも簡単に変換できる。気をつけることは、rowはviewにしか存在しない概念なので、NSOutlineViewで変換するしかないことぐらい。

型	方法
NSIndexPath	NSTreeNode.indexPath
NSManagedObject	NSTreeNode.representedObject
row	[NSOutlineView rowForItem:NSTreeNode]

NSIndexPathから各種Objectへの変換

一度NSTreeNodeに変換してからそれぞれの型に変換する。

型	方法
NSTreeNode	[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath]
NSManagedObject	[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath].representedObject
row	[NSOutlineView rowForItem:[NSTreeController.arrangedObjects descendantNodeAtIndexPath:NSIndexPath]]

NSManagedObjectから各種Objectへの変換

NSTreeController.arrangedObjectsを使って、総なめする以外には方法はない。

コーディングするときは、NSManagedObjectは中間表現としては使ってはならない。NSIndexPathかNSTreeNodeを使用すること。

rowから各種Objectへの変換

rowはviewにしか存在しない概念なので、NSOutlineViewでNSTreeNodeへ変換する。その後、それぞれの型に変換する。

型	方法
NSIndexPath	[NSOutlineView itemAtRow:row].indexPath
NSTreeNode	[NSOutlineView itemAtRow:row]
NSManagedObject	[NSOutlineView itemAtRow:row].representedObject

なお、キャストなどは省略した。上記のコードはコピペでは動かない。

sphinxのadmonition用にcssを書いたの続き

Mon, 06 Feb 2017 00:00:00 +0900

sphinxのadmonition用にcssを書いたの続き

前回のアイコンはサイズも適当に作成していた。画像の余白を削り、サイズも統一した。さらに、CSSを変更して、タイトル部分をboldにして、それぞれの要素のマージンを合わせた。

Caution

caution用のディレクティブはこう。old mac風のアイコンで区別できるようにしてみてます。なかなかにそれっぽくできた。

Danger

危険(?)のディレクティブをかくとこんな感じ。前回は爆弾マークだったのだが、テロ推奨マークのようであまりいい感じがしなかったので、ドクロマークに変更した。

Note

ノート用のディレクティブはこう。この”Note”や”Danger”の文字を消すには、コラムディレクティブ(http://sphinx-users.jp/cookbook/columndirective/index.html)を使う必要があるみたい。CSSのfloat属性とPaddingをうまく使って、”Note”や”Danger”の文字をアイコンの下へつけるようにした。

Tip

tipのディレクティブをかくとこんな感じ。本文の上辺のpaddingもアイコンの上辺と合わせたつもり。

Warning

警告用のディレクティブをかくとこんな感じ。種類によって背景色も変えた方が良いかもと思って色々と試した。が、色をつけると以外に下品になる。色についてはAppleHelpFileを作るときにもう少し考えてから行うことにする。

cssの実装方法は、htmlのソースとcssのソースを見ればすぐにわかると思うので特に記述しない。

sphinxのadmonition用にcssを書いた

Tue, 31 Jan 2017 00:00:00 +0900

sphinxのadmonition用にcssを書いた

適当にアイコンを作り、コラム風に囲ってみた。

cssの実装方法は、htmlのソースとcssのソースを見ればすぐにわかると思うので特に記述しない。

(注意) CSSを変更して、再ビルドしたため上記は、画像ファイルに差し替えた。

NSAtomicStoreサブクラスの作成のメモ

Wed, 25 Jan 2017 00:00:00 +0900

NSAtomicStoreサブクラスの作成のメモ

CoreDataがサポートしてい保存形式

CoreDataはデータ保存形式として予め以下の4つの形式をサポートしている。

	指定文字列	description
SQLite	NSSQLiteStoreType	SQLiteに保存する
バイナリ	NSBinaryStoreType	バイナリ形式でfileに保存する
XML	NSXMLStoreType	XML形式でfileに保存する。iOSにはない。
in Mmemory	NSInMemoryStoreType	メモリだけ使用し保存しない。

これらのStoreTypeを目的に応じて使い分けることができる。そして目的に合わない場合に、自作することも可能である。

クラス階層

ここでは、NSBinaryStoreTypeやNSXMLStoreTypeと同じatomicな読み書きを行い、独自のファイ形式をサポートするStoreタイプの作成方法を説明する。

まずは、既存のStoreTypeがどのクラス階層に属しているかを示す。残念ながら、既存のStoreTypeのクラスはドキュメント化されていないので指定用文字列をクラス名の代わりに使用している。

クラスNSPersistentStoreは、CoreDataで使用する永続化方式の抽象クラスです。このクラスのサブクラスを書くことで、CoreDataのデータを任意の媒体に保存できるようになる。デザインパターンで言うところの、テンプレートパタンやストラテジーパタンで設計されている。

NSIncrementalStoreは、部分的に保存することができるStoreの抽象クラスです。既存のクラスではNSSQLiteStoreTypeがこのクラスを継承している。他のデータベースやNoSQL的なものをサポートしたい場合は、このクラスを継承して作ることになる。

NSAtomicStoreは、データを保存するときに一括で保存する必要があるStoreの抽象クラスです。既存のクラスではNSBinaryStoreTypeとNSXMLStoreTypeがこのクラスを継承している。

このNSAtomicStoreのサブクラスを作成することで、CoreDataの保存形式に独自のファイルフォーマットを導入する。

実行時のオブジェクトグラフとNSAtomicStoreCacheNode

NSAtomicStoreのサブクラスの内部では、NSManagedObjectのデータをNSAtomicStoreCacheNodeに対1で転写して使用する。 NSAtomicStoreCacheNodeはサブクラス化しなくとも問題なく使える。

NSAtomicStoreCacheNodeとNSManagedObjectとNSAtomicStoreの関係は、以下の3点だけ覚えておけば問題ないはず。

NSAtomicStoreCacheNodeはNSAtomicStoreに所有される。
NSAtomicStoreCacheNodeはNSManagedObjectと1:1で関係する。
NSAtomicStoreCacheNodeを区別する識別子を割り当てる。

図で示すと、以下のようになる。

NSAtomicStoreをサブクラス化するには

NSAtomicStoreをサブクラス化するにあたっての、上書きすべきメソッドは大別して2つのグループに分かれる。

メタデータの管理系のメソッド

- (id)initWithPersistentStoreCoordinator:(NSPersistentStoreCoordinator*)coordinator
                       configurationName:(NSString*)configurationName
                                     URL:(NSURL*)anUrl
                                 options:(NSDictionary *)options

+ (NSDictionary *)metadataForPersistentStoreWithURL:(NSURL*) url
                                              error:(NSError*__autoreleasing*) error

+ (BOOL)        setMetadata:(NSDictionary*) metadata
  forPersistentStoreWithURL:(NSURL*) url
                      error:(NSError*__autoreleasing*) error

- (NSString*)type
- (NSString*)identifier

initWithPersistentStoreCoordinator…は、初期化メソッド。ここで、メタデータを読み込むか初期化する必要がある。
metadataForPersistentStoreWithURL…は、メタデータの読み込みメソッド。指定されたURLからメタデータを読み込む。
setMetadata…は、メタデータの書き込みメソッド。指定されたURLからメタデータを書き込む。
typeは、クラスの識別子を返します。この識別子によって、CoreDataは新たに作成したNSAtomicStoreのサブクラスを認識できます。[NSPersistentStoreCoordinator registerStoreClass:forStoreType:]に渡す文字列。NSSQLiteStoreTypeやNSXMLStoreTypeと同じ目的の文字列。
identifierはインスタンスの識別子です。保存して再生した場合は、また同じ値を返す必要があります。そーでないと識別子として動作しない。

NSAtomicStoreCacheNodeの管理系のメソッド

- (BOOL)load:(NSError*__autoreleasing*) error
- (BOOL)save:(NSError*__autoreleasing*) error

- (NSAtomicStoreCacheNode*)newCacheNodeForManagedObject:(NSManagedObject*) inManagedObject
- (void)updateCacheNode:(NSAtomicStoreCacheNode*)node fromManagedObject:(NSManagedObject*)managedObject
- (id)newReferenceObjectForManagedObject:(NSManagedObject*) managedObject

load…はファイルからデータを読み込ませる。
save…はファイルへ保存させる。
newCacheNodeForManagedObject..は与えられたNSManagedObjectに対応するNSAtomicStoreCacheNodeを作成する
updateCacheNode…はnodeへmanagedObjectの内容を反映させる。
newReferenceObjectForManagedObjectはNSManagedObjectの識別子を生成する。保存して再生した場合は、また同じ値を返す必要があります。そーでないと識別子として動作しない。

ファイルフォーマットの設計

NSAtomicStoreのサブクラスを作成して、CoreDataを任意のファイルフォーマットに対応させるにはいくつかの条件がある。

ファイルを区別するためのNSStoreUUIDKeyの値の保存が必要。メソッドidentifierがその値を返す必要がある。
レコードに相当するNSManagedObjectを区別するための、リファレンスの保存が必要。
テーブルに相当する値を何らかの方法で識別する必要がある。

ここで、plist形式やxml形式などの汎用ファイルフォーマット形式であれば対応可能。既存のファイルフォーマットに上記の条件を合わせるには何らかの工夫が必要になる。

全てのCoreDateのファイルを保存するのでなければ、それなりに簡単にできる。

ここでは、以前作成したToDoアプリ元にcsv形式での読み書きをサポートさせてみる。

以下のようにした。

1行目はメタファイル行。metaDataのUUIDの値
2行目以降は通常のcsvファイル
ToDoアプリのみサポート。テーブル名は保存しない。
項目は、done, memo, sortOrder, 作成日, uuid(レコードのuuid値)

具体的にはこんな感じ。

#D35CF030-1EC1-4667-9666-70C8247A1010
1, insertCurrent, 2, 2016-09-17 18:15:00 +0000, E899556C-BE1A-42A3-A634-F8411915C05F
0, insertCurrent, 5, 2016-09-17 18:15:00 +0000, 803054FC-C497-4DD7-A078-CF592B994EB4
1, insertCurrent, 3, 2016-09-17 18:15:00 +0000, 569485BA-A1E2-4E5B-88B5-6D5DB2C8AB8F
0, insertCurrent, 1, 2016-09-17 18:15:00 +0000, 65A95220-A09F-4000-9F3C-EC8448D5DCB7
0, addLast, 0, 2016-09-17 18:15:00 +0000, F7C54A12-8CA6-4A4A-9D45-1A92E23922F9
1, insertCurrent, 4, 2016-09-17 18:15:00 +0000, 5CE1C138-32A3-4CE8-9917-84C941011C09

CoreDataへの登録とinfo.plistへの追加

NSAtomicStoreのサブクラスを使用するには、NSPersistentStoreCoordinatorに登録する必要がある。適当な場所に以下のコードを書いて、登録する。applicationDidFinishLaunchingが良いと思う。

[NSPersistentStoreCoordinator registerStoreClass:[TDLAtomicStore class]
                                    forStoreType:TDLAtomicStoreType];

同じく、NSPersistentDocumentと一緒に使う場合は、info.plsitにDocument typeを追加する。

CFBundleDocumentTypes
               
                       CFBundleTypeExtensions
                       
                               csv
                       
                       CFBundleTypeMIMETypes
                       
                               text/csv
                       
                       CFBundleTypeName
                       CSV
                       CFBundleTypeRole
                       Editor
                       LSTypeIsPackage
                       0
                       NSDocumentClass
                       TDLDocument
                       NSPersistentStoreTypeKey
                       TDLAtomicStoreType
               

と登録しておけばOK。これで、.csvの拡張子のファイルを開けるようになるし、”save as..”でTDLAtomicStoreTypeの保存方式が使えるようになる。

ソースコードの解説

めんどくさくなってきたので、Cocoa勉強会Matudoで説明します。https://connpass.com/event/46754/

ファイルTDLCSVAtomicStore.h.mにまとまってます。

ソースコードはここ。( ModernToDoList_atomicStore.zip )

cocoaのモデルデータ関連技術のメモ

Tue, 10 Jan 2017 00:00:00 +0900

cocoaのモデルデータ関連技術のメモ

指先を怪我したのでバンドエイドを貼ったら、trackPadが反応してくれない。モチベーションが落ちる。

ローカルへの保存方法

cocoaアプリのファイルの保存形式では大別して以下の4つがある。

	保存形式	大量データ	複雑なデータ	その他
手書き	気合い	気合い	気合い
NSKeyedArchiver	非公開	r/wに時間がかかる	重複処理あり
CoreData	非公開	一部だけ読み出せる	重複処理あり	undo/redoサポート
plist	公開	r/wに時間がかかる	重複処理なし

この表だけを見ると、お手軽さや機能を考えればCoreData一択。

model-viewの同期方法

Cocoaアプリのモデルとviewの同期方法には主に以下の4つがある。

	依存性	code or nib	その他
手書き		コード
cocoa binding	iOSで使えない	nib
fetchResultController	CoreData前提	コード	coreDataがiCloudStorageと相性が悪い
KVOとaction		コード

CoreDataを使う場合は、FetchResultControllerとKVOを使って書くのがよさげ。 CoreDataを使わない場合は、ButtonなどはKVOで書いて、TableViewはデリゲートを使った手書きになりそう。

データの保存と違って、手法の混在できるので、適材適所で行うのが良い。

デバイス間のドキュメントの同期方法

調べている途中で気がついたのですが、CoreData Storage 又はCoreData in iCloudと呼ばれる技術はDeprecatedになりました。 CoreDataを使って、iCloud経由でドキュメントを同期できる夢の技術だったのですが、致命的なバグでもあったのでしょう。

で、デバイス間のドキュメント同期技術は以下の2つです。

iCloud document storage

file単位に基づく同期。DropBoxのApple版といった所。PowerPointやWordのようなタイプの書類ベースのアプリとは相性が良いかもしれない。

変更部分だけのマージが出来ないので、巨大なバイナルファイルを丸ごと入れ替えになる。

CloudKit storage

クラウドにデータを置くことが主眼。グラウドにあるデータが主となる。JSからの呼び出しをサポートしているので、webアプリを作る場合は必須。

ネットに繋がっていないと使えない欠点がある。FileMakerやEverNoteのようなパーソナルデータベース型のアプリとは相性が良いかもしれない。

ローカルキャッシュをCoreDataに、ネットに繋がっている時にCloudKitで同期を行うと、上記の欠点を解消できる。

デバイス間の操作状態同期方法

同じユーザーアカウントの別デバイスに操作状態を引き継げる。

NSUserActivityを設定するらしい。使ったことないけど。

https://developer.apple.com/jp/documentation/UserExperience/Conceptual/Handoff/HandoffFundamentals/HandoffFundamentals.html

NSOrderedSetの感想

NSOrderedSetが使えそうで使えない。

CoreDataでは、NSOrderedSetをサポートしている。しかし、NSArrayControllerがOrdersSetに対応していない。

bindingでNSTablbeViewの中に順列を使うには、NSSet & NSSortOrderの組み合わせで表現する必要がある。

bindingでなくNSFetchResultControllerを使用しても良い。

CoreData中のNSOrderedSetはCoreDataの思想とあまり相性が良くないのかもしれない。

bindingでのサポートだけでなく、CoreDataInCloudでもサポートが無かった。

地雷を踏み抜かないように、SortOrderを使った昔ながらの手法を使用した方が良い。

MacOSX用アプリ”CardBook.app”をビルドする

Mon, 05 Dec 2016 00:00:00 +0900

MacOSX用アプリ”CardBook.app”をビルドする

ノートテーカー系のアプリを作成しようと思い、参考になりそうなソースコードを漁っていると良さげなアプリをまた見つけた。

CardBook.app http://www.paullynch.org/macosx/cardbook/ https://github.com/pauldlynch/CardBook

細かい実装を丁寧にこなしている印象なメモアプリ。

修正

Copy&PasteやDrag&Drop時に例外を吐いたの少しだけ修正しました。原因はNSArchiverの書き出しが現在のMacOSXではサポートされていないため。対応として、NSArchiverをNSKeyedArchiverに、NSUnarchiverをNSKeyedUnarchiverに書き換える以外は何もしていない。

修正箇所はファイルMyDocument.mの以下の2つのメソッドだけ。

[MyDocument copyRows:toPasteboard:]

- (void)copyRows:(NSArray *)rows toPasteboard:(NSPasteboard *)pboard {
   NSArray *array = [self cardsForRows:rows];
   // NSArchiverをNSKeyedArchiverに置き換え
   NSData *data = [NSKeyedArchiver archivedDataWithRootObject:array];// <-- ここ
   NSMutableAttributedString *aString = [[NSMutableAttributedString alloc] initWithString:@""];
   NSEnumerator *e = [array objectEnumerator];
   Card *card;
   while (card = [e nextObject]) {
       [aString appendAttributedString:[card card]];
   }
   [pboard declareTypes:[self pboardTypes] owner:self];
   [pboard setData:data forType:CardPboardType];
   [pboard setString:[aString string] forType:NSStringPboardType];
   [pboard setData:[aString RTFDFromRange:NSMakeRange(0, [aString length]) documentAttributes:nil] forType:NSRTFDPboardType];
   [pboard setData:[aString RTFFromRange:NSMakeRange(0, [aString length]) documentAttributes:nil] forType:NSRTFPboardType];
   [aString release];
}

[MyDocument addCardFromPboard:atRow:]

- (void)addCardFromPboard:(NSPasteboard *)pboard atRow:(NSInteger)row {
   Card *card;
   NSData *data;
   NSString *type;

   type = [pboard availableTypeFromArray:[self pboardTypes]];

   if ([type isEqual:CardPboardType]) {
       NSEnumerator *e;
       NSArray *cardArray;
       data = [pboard dataForType:CardPboardType];
       // NSUnarchiverをNSKeyedUnarchiverに置き換え
       cardArray = [NSKeyedUnarchiver unarchiveObjectWithData:data];//<--ここ
       e = [cardArray objectEnumerator];
       while (card = [e nextObject])
           [self addCard:card atRow:row];
   }
   if ([type isEqual:NSRTFDPboardType]) {
       data = [pboard dataForType:NSRTFDPboardType];
       card = [Card card];
       [card setCardRTFD:data];
       [self addCard:card atRow:row];
   }
   if ([type isEqual:NSRTFPboardType]) {
       data = [pboard dataForType:NSRTFPboardType];
       card = [Card card];
       [card setCardRTF:data];
       [self addCard:card atRow:row];
   }
   if ([type isEqual:NSStringPboardType]) {
       NSString *pboardString = [pboard stringForType:NSStringPboardType];
       card = [Card card];
       [card setCardString:pboardString];
       [self addCard:card atRow:row];
   }
}

修正したソースコードはここ。( CardBook-master.zip )

ソースコードの特徴

作成された年代的に以下の技術は使用されていない。

cocoa binding
core data
restore state
プロパティ
ARC
NSViewController

素直に、コードで書かれている。window位置が再生されるのは、保存ファイルに位置を書き込んでいるから。データの保存は、伝統的なNSKeyedArchiverを使用している。

印刷時にはCardsViewクラスを使ってA4の紙に複数のカードを纏めて印刷可能にしている。最近印刷を前提としていないアプリばかりなので、これは時代的なものなのかもしれない。

他にも、AppleScript用のリソースやローカライズリソースなども存在しており、丁寧に作られているように見える。

UIの特徴

NSTableViewとNSTextEditViewの組み合わせで特に特徴的なものはない。

しかし、Wiki文法やmarkDownを使うことなく、RTFDな修飾を直接使う方がフツーに便利かもと再考させられた。

カード間リンクはない。 “フォーカス”機能で一部のカードだけをリストアップする機能がある。

標準のメモアプリの使用感が一番近いかもしれない。

GNUstep用アプリ”MyWiki.app”をビルドする

Sat, 03 Dec 2016 00:00:00 +0900

GNUstep用アプリ”MyWiki.app”をビルドする

ノートテーカー系のアプリを作成しようと思い、参考になりそうなソースコードを漁っていると良さげなアプリを見つけた。

MyWiki.app http://wiki.gnustep.org/index.php/MyWiki.app

Objective-Cで書かれた、サーバーなしのDesktop用のwikiアプリ。

残念ながら、十年以上前のコードなのでそのままではビルドが出来ないので、手直ししてビルド。修正したソースコードはここ。( MyWiki_test.zip )

カレンダーViewとページ作成日を利用した日誌ページの作成機能が面白い。作成日でまとめるために自動で日誌が出来上がる。

コードを読んでいて面白いのは、NSTextViewの本文中にコラムを作る手法が良くできている。 NSTextViewにNSTextAttachmentを使って、アイコンと文字列を表示させている。

自作ノートテーカーアプリには、文書中に”注意”や”意見”を入れたいと思っていたのでこの機能はパクりたい。

ユーザーとしての使い方は文字列をnoteタグで囲むだけでコラムができるのはお手軽で良い。

問題はDrag&Dropやコピペがうまくゆかない。NSTextAttachmentをコピーするときに、NSTextAttachmentの内容を書き出せば可能かもしれない。

PlantUMLのsalt言語

Wed, 23 Nov 2016 00:00:00 +0900

PlantUMLのsalt言語

以前、オブジェクトグラフを書くのにdot言語を使用した( xibファイルの中のオブジェクト図 )。

この時に「テキストデータからGUI設計用の図を生成するDSLはないものか？」と思っていた。ググると意外な場所で見つかった。

有名なPlantUMLの中のsalt言語がそれ。(http://plantuml.com/salt)

@startuml
salt
{+
.   |CurrencyConverter|*
--- | ---          | ---
.|{
.   | Doller:  | "Input"    |*
.   | rate:    | "input"    |*
.   | Yen:     |  output    |*
.   | [Reset]  |  [Convert] |*
}|*
}
@enduml

テキストファイル、mainWindow.puに以上のように書いて、

$ java -jar path/to/plantuml.jar -p -tpng < mainWindow.pu > mainWindow.png

と実行すると、

こんな画像が得られる。

メニューバーなども作ったり、makefileなども作って可能性を探った。資料はここ。( plantUML-salt.zip )

結論：webアプリケーション用に設計されたようで、私の用途には表現が弱すぎる。スクリーンショットか手書きの方が良さげ。

シェアウェア、やって良い事、悪い事

Sat, 19 Nov 2016 00:00:00 +0900

シェアウェア、やって良い事、悪い事

11/19のCocoa勉強会で発表予定の資料。

十年以上前の以下の記事を元に現在のアプリビジネスとプログラム開発を話します。

シェアウェアでやって良い事と悪い事その1 (http://www.macdevcenter.com/pub/a/mac/2002/09/30/dev_osx.html)

シェアウェアでやって良い事と悪い事その2 (http://www.macdevcenter.com/pub/a/mac/2002/10/08/dev_osx.html)

シェアウェアでやって良い事と悪い事その3 (http://www.macdevcenter.com/pub/a/mac/2002/10/25/dev_osx.html)

上記の勝手翻訳資料は会場にてお渡しします。

ProxyResponder nibファイルを超えたTarget/action

Thu, 17 Nov 2016 00:00:00 +0900

ProxyResponder nibファイルを超えたTarget/action

11/14のCocoa勉強会で発表予定だった資料。 nibの外にあるObjectにactionを送り込む手法の説明。

代理オブジェクトをnib上に作成して、メソッドforwardInvocation:を利用して外部のobjectへメソッドを転送しています。

資料はここ。( ProxyResponder.zip )

NSTableViewのUIを改良する、その2

Sat, 10 Sep 2016 00:00:00 +0900

NSTableViewのUIを改良する、その2

一歩後退して、NSTextField周りを調べたのでメモる。

NSTextFieldの描画領域のマージン

NSTextFieldの描画領域boundsと[NSAttributedString boundingRectWithSize:options:context]が返す描画領域は一致しない。 NSAttributedStringの描画領域と一致するのは、[NSCell drawingRectForBounds:]の値の方。

[NSCell drawingRectForBounds:]は、NSControl中のNSCellの描画領域を計算するメソッド。

おそらく、ControlとCellの差は、フォーカスリング分の差と思われる。

テキストの分量に応じて、NSTextFieldの描画サイズを可変にするときに、上記のControlとCellの差を考慮に入れて計算する必要がある。

詳しくはソースコードの[NSTextField interSpacing]と[NSTextField calcBoundingHeightWithFixedCurrentWidth]を参照すること。

NSTextField間の移動をカーソルキーで行う

[NSTextFieldDelegate control:textView: doCommandBySelector:]に記述するのは基本。

左右の矢印キーを押すと、”moveRight:”や”moveLeft:”のセレクタが来る。

この時に、キャレットが文末や文頭にあった場合にnextKeyViewやpreviousKeyViewにフォーカスを移動する。これだけだと、フォーカスが移動しツァキのNSTextFieldのテキストが、全て選択されてしまう。

以下のように、currentEditorにmoveToEndOfDocument:を投げることで移動先のキャレットを移動すると良い。

NSTextField* theTextFiled = (NSTextField*)control.previousKeyView; [theTextFiled becomeFirstResponder]; [theTextFiled.currentEditor moveToEndOfDocument:nil];

キャレット位置の判定や移動方法はソースコードを参照のこと。

現状のソースコードの欠点は、キャレットの縦方向移動開始時にX軸の値を保存していないため、NSTextField間の移動時後にキャレットのX軸がズレることがある。

ソースコードはここ。( TextClassTester.zip )

ライフゲームその3

Mon, 05 Sep 2016 00:00:00 +0900

ライフゲームその3

最小限のセル編集機能つきのライフゲームの作成。

方針は、以下の2つ。

今までと同じモデルクラスを使う

表示編集はフレームワーク既存のクラスを組み合わせてでっち上げる。

GUIの見た目はこんな感じになります。

GUIパーツの配置と接続

XIBファイルの追加はこんな感じで画面を作ります。

中央のNSSCrollViewの中身は、NSButtonCellを含んだNSMatrixです。

Nibのoutletの接続は、以下のようになります。

Nibのactionの接続は以下のようになります。

ViewControllerだけの図にした方がわかりやすかったかもしれませんが、面倒なので修正はしません。

ViewControllerでモデルクラスと対話させる

各種ボタンが呼び出している、機能は単純にモデルクラスの機能を呼び出しているだけです。

runメソッドを呼び出すと行われる、自動で次の世代へ行くのはNSTimerを使っています。

分かりにくい物は、NSMatrix周りのメソッドです。

nibの読み込み時に、NSMatrix中のCellのprototypeをNSOnOffButtonに変更しています。これは、見た目はラジオボタンだけと、昨日はOnOffボタンに変更するためです。

- (void)viewDidLoad { [super viewDidLoad]; NSButtonCell* theCell = self.matrix.prototype; [theCell setButtonType:NSOnOffButton];

NSMatrixがクリックされると以下のメソッドが呼ばれます。マトリクス中のどのNSButtonCellがクリックされたか区別できなかったので(詳しく調べればわかるはず)強引にNSMatrixの値をモデルの値に同期させています。

- (IBAction) toggleCell:(id)sender;

これ以外のメソッドは単純で解説の必要はないと思われます。

ソースコードはここ。( LifeGameOnMac_02.zip )

こんな感じでだいたい終わり。

ライフゲームその2

Sat, 03 Sep 2016 00:00:00 +0900

ライフゲームその2

先日のコードより後退して、最小限のコードを書いた。

初期状態はコード上で決め打ち。

出力はLog出力の最小限アプリ。

以上の2点しかないのに、テンプレートから作成したので無駄なWindowが出る。

モデルクラスの使い方

モデルクラスは、LGOMModelです。インスタンス化する時に、格子のサイズを指定して作成します。

{ LGOMSize theSize = {32, 32}; self.model = [LGOMModel modelWithSize:theSize]; . . .

上記は、32x32の格子サイズを持つライフゲームのモデルを作成します。

初期状態の設定

初期状態の設定用に3つのメソッドを用意しています。

// すべてのセルを非生存状態にします。 - (void) clearAll; // すべてのセルの生存状態/非生存状態を乱数で設定します - (void) randomizeAll; // 文字列でセルの状態を指定します。 - (void) gameBoardSetup:( NSString* _Nonnull )inNewLifeGameBoard;

clearAllとrandomizeAllはコメントの通りです。 gameBoardSetupメソッドに引き渡す文字列は、以下のような形式になります。

// 8x8の格子でLGOMModelを作成した場合 [model gameBoardSetup: @"........\r" @"...OOO..\r" @"........\r" @"........\r" @"........\r" @"...OOO..\r" @"........\r" @"........\r"

それぞれの文字の意味を以下の表に示します。

文字意味

“O” セルが生存状態

“.” セルが非生存状態

“r” 次の行、または終了マーカー

世代の進行

メソッド”next”を呼び出すと、モデルの内容を次の世代に書き換えます。

各セルの値の確認と変更

それぞれのセルの状態を確認変更するメソッドは以下の2つです。

// inPointで示す位置のセルの状態をBOOLで返します。YES:生存 NO:非生存 - (BOOL) aliveAtPoint:(LGOMPoint)inPoint; // inPointで示す位置のセルの状態をinAliveで指定した値に変更します。 - (void) setAlive:(BOOL)inAlive atPoint:(LGOMPoint)inPoint;

すべてのセルの状態確認

descriptionメソッドで出力するようにしています。

- (NSString*) description

サンプルコードでの使用方法

NSApplicationのdelegateに設定している、LGOMApplicationDelegateの中のawakeFromNibメソッドで使用しています。

- (void) awakeFromNib { LGOMSize theSize = {32, 32}; self.model = [LGOMModel modelWithSize:theSize]; [self.model gameBoardSetup: @"................................\r" @"...OOO..............O...........\r" // ブリンカー @"....................OO..........\r" // ブロック @"...........OOOO.................\r" // 蜂の巣 @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @".............OOO................\r" // Tテトロミノ @"..............O.................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"...O............................\r"// グライダー @"....O...........................\r" @"..OOO...........................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r" @"................................\r"]; NSLog(@"\r%@\r", self.model ); [self.model next]; NSLog(@"\r%@\r", self.model ); [self.model next]; NSLog(@"\r%@\r", self.model ); [self.model next]; NSLog(@"\r%@\r", self.model ); [self.model next]; NSLog(@"\r%@\r", self.model ); [self.model next]; NSLog(@"\r%@\r", self.model ); [self.model next]; }

出力結果は以下の通り。

2016-09-04 23:21:11.141 LifeGameOnMac[38776:1497000] ................................ ...OOO..............O........... ....................OO.......... ...........OOOO................. ................................ ................................ ................................ ................................ ................................ .............OOO................ ..............O................. ................................ ................................ ................................ ................................ ...O............................ ....O........................... ..OOO........................... ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ 2016-09-04 23:21:11.144 LifeGameOnMac[38776:1497000] ....O........................... ....O...............OO.......... ....O.......OO......OO.......... ............OO.................. ............OO.................. ................................ ................................ ................................ ..............O................. .............OOO................ .............OOO................ ................................ ................................ ................................ ................................ ................................ ..O.O........................... ...OO........................... ...O............................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ ................................ 以下省略

多分、最も原始的なCocoaアプリでのライフゲイムだと思う。

ソースコードはここ。( LifeGameOnMac_01.zip )

次は、GUIで編集できるコードの解説をします。じゃあね。

ライフゲームその1

Fri, 02 Sep 2016 00:00:00 +0900

ライフゲームその1

Mosa勉強会資料。

眠いのでソースコードだけ。( LifeGameOnMac.zip )

NSTableViewのUIを改良する、その1

Tue, 23 Aug 2016 00:00:00 +0900

NSTableViewのUIを改良する、その1

Cocoa勉強会資料。入力した文字列の長さに応じて行の高さを調整するコードです。プロジェクトファイルはここに置いてきます。( TableViewUX.zip )

その2は無いかもしれない。

Sphinxで作るApple help book

Fri, 19 Aug 2016 00:00:00 +0900

Sphinxで作るApple help book

目的

Sphinxは美しいドキュメントを簡単に作れるようにするマンドラインツールです。これを転用して、アプリケーションのオンラインマニュアルを作成ができます。

Apple help bookはMacアプリケーションのオンラインマニュアルの形式です。このApple help bookはhtmlで表記する必要があります。

html直書きよりも簡易な表記が可能なドキュメント作成ツールSphinxでオンラインマニュアルを作成すると、ほんのりラクが出来る気がします。

Sphinxの出力形式にApple help book形式が2015年に追加されたましたので、少しだけ調べてみました。

作成手法

最小限の手間で既存のCocoaアプリケーションに、Sphinxで作成したオンラインヘルプを追加する方法を示す。流れは以下の5つの手順。

Sphinx-quick-start

configファイルの変更

XCodeにスクリプトフェーズの追加

apple help book fileをResorceとして追加

info.plistの変更

Sphinx-quick-start

以下のような既存のプロジェクトにSphinxのコードを追加します。

. ├── HalloWorld/ └── HalloWorld.xcodeproj

このディレクトリに、sphinxディレクトリを作成しそこを、カレントディレクトリにします。

. ├── HalloWorld/ ├── sphinx/ <--- 今作った。 └── HalloWorld.xcodeproj

sphinx-quickstartコマンドでsphinxのテンプレートファイルを設置します。(私の環境では、2.7系のコマンドしかうまく動かなかったので、2.7系で使用しています)

$ sphinx-quickstart-2.7 Welcome to the Sphinx 1.4.3 quickstart utility. . . . > Root path for the documentation [.]: > Separate source and build directories (y/n) [n]: y > Name prefix for templates and static dir [_]: > Project name: HalloWorld <—- 重要 > Author name(s): HalloWorld Author > Project version: 1.0 > Project release [1.0]: 1.0 > Project language [en]: ja <—- 重要 > Source file suffix [.rst]: > Name of your master document (without suffix) [index]: > Do you want to use the epub builder (y/n) [n]: > autodoc: automatically insert docstrings from modules (y/n) [n]: > doctest: automatically test code snippets in doctest blocks (y/n) [n]: > intersphinx: link between Sphinx documentation of different projects (y/n) [n]: > todo: write "todo" entries that can be shown or hidden on build (y/n) [n]: > coverage: checks for documentation coverage (y/n) [n]: > imgmath: include math, rendered as PNG or SVG images (y/n) [n]: > mathjax: include math, rendered in the browser by MathJax (y/n) [n]: > ifconfig: conditional inclusion of content based on config values (y/n) [n]: > viewcode: include links to the source code of documented Python objects (y/n) [n]: > githubpages: create .nojekyll file to publish the document on GitHub pages (y/n) [n]: > Create Makefile? (y/n) [y]: > Create Windows command file? (y/n) [y]: n <—- 重要

コマンドを実行すると、上記のように幾つか質問されます。重要点は3点だけです。

重要な項目

設定項目説明

Project name 生成されるApple help bookのファイル名になります。

Project language ローカライズに使用されます。日本語ならばjaを使用します。

Create Windows command file? 信仰心が試される箇所です。最後まで気を抜かずに、必ずnにしましょう。

コマンドの実行が終了すると、以下のようなディレクトリ構造になります。

. ├── HalloWorld/ ├── HalloWorld.xcodeproj └── sphinx ├── Makefile ├── build └── source

configファイルの変更

sphinx/source/conf.pyを編集します。変更箇所は1箇所です。

# apple help book bundle のCFBundleIdentifierの値の設定。 applehelp_bundle_id = 'com.mindto01s.HalloWorld.help'

上記の1行を適当に追加してください。

この状態で、make applehelpを行うと、apple help fileが作成されます。ただし、この状態では、アプリケーションバンドルにはコピーされませんし、ヘルプメニューから呼び出すこともできません。

XCodeにスクリプトフェーズの追加

XCodeでビルドした時に、自動でsphinxのmakeファイルを呼び出すために追加します。

追加したコードを以下に示します。

cd "./sphinx/" PATH=${PATH}:/opt/local/bin make applehelp

PATHに/opt/local/binを追加しているのは、私がMacPortsを使用しているため。他の方法でsphinxをインストールしてるならば別の場所のPATHを書いてください。

この時点で、XCode上でsphinxもビルド可能になります。

apple help book fileをResorceとして追加

XCode上で一度ビルドすると、”./sphinx/build/applehelp/”に、”HalloWorld.help”というapple help bookバンドルができます。これを”Copy Bundle Resources”に追加します。

これで、XCode上でビルドすると、アプリケーションバンドルに含まれるようになります。

info.plistの変更

最後に、info.plistに以下の2項目を追加して、アプリケーションにバンドル内のApple help bookを認識させます。

info.plistに追加する項目

キー値説明

CFBundleHelpBookName com.mindto01s.HalloWorld.help conf.pyで設定したapplehelp_bundle_idの値

CFBundleHelpBookFolder HalloWorld.help AppleHelpBookのフォルダ名

これで、アプリ実行後に、Helpメニューから”HalloWorld Help”を選ぶと以下のページが表示される。

Apple help book作成に関連するSphixの設定

Sphinxのoption項目で、Apple help bookに関連する項目の一覧です。

apple help book bundle用info.plsitの設定

applehelp_bundle_name

Apple Help Bookのベース名です。デフォルトでproject名が使用される。

applehelp_bundle_id

Apple Help BookのバンドルID(必須)。CFBundleIdentifierに反映される。

applehelp_dev_region

Apple Help BookのCFBundleDevelopmentRegionに反映される。デフォルトで’en-us’

applehelp_bundle_version

Apple Help Bookのバージョン文字列。デフォルトで1。CFBundleVersionに反映される。

多分、applehelp_bundle_id以外は設定しないで良いハズ。

その他の設定

applehelp_disable_external_tools

この値がTrueだと、indexerやcodesignなどのコマンドラインツールを呼び出しません。つまり、MacOSX以外でビルドのテストを使用するときに使います。デフォルトで、false。

applehelp_locale

バンドルのResourceフォルダーの中のロケールフォルダー(*.lproj)の生成に使われます。ここが、enならば、en.lprojを生成し、jpnならば、jp.lprojを生成します。デフォルトでlanguageの値。

applehelp_icon

Apple Help Book用の16x16ピクセルのアイコンのファイル名。Apple Helpのリスト表示などの使われます。

必須でないけと設定してiconを作成しないとみっともないので、applehelp_iconは設定した方が良い。その他は設定は不要と思います。

出力されるhtmlファイルの設定

applehelp_title

ヘルプファイルのタイトルの設定。デフォルトでは ‘ Help’です。 info.plistのHPDBookTitleの変更と、html中のタグの変更。</dd> <dt>apple help bookの出力は、既存のhtml出力のビルダーから継承されているので、html関連のoptionを変更すると変更できます。</dt> <dd>このapplehelp_title項目は設定しなくても良いと思います。</dd> </dl> </div> <div class="section" id="indexer"> <h3>indexer用の設定</h3> ヘルプファイルのindexを作成するためのコマンドラインツール用のoptionです。多分使わない。 <dl class="docutils"> <dt>applehelp_indexer_path</dt> <dd>hiutilコマンドへのパスの変更。変更する必要なし。</dd> <dt>applehelp_index_anchors</dt> <dd>コード上からAppleHelpBookのページを呼び出すための、アンカー用indexを作成するか否か。Trueにする。アンカーの表記方法は知らない。</dd> <dt>applehelp_min_term_length</dt> <dd>hiutilに渡すminmum term lengthの引数。an とかtheとかをindexに含めないようにするためのもの。変更の必要はないだろう。</dd> <dt>applehelp_stopwords</dt> <dd>hiutilに渡すstop wordの引数。’about’や’then’などの単語をindexに含めないように、あらかじめstopWordとして登録しておいた単語を指定するためのもの。普通は変更する必要なし。デフォルトの登録内容でOK.</dd> </dl> </div> <div class="section" id="codesign"> <h3>codesignの設定</h3> apple help book バンドルに署名する必要があるときに使用するらしい。使うことがあるとは思えない。 <dl class="docutils"> <dt>applehelp_codesign_identity</dt> <dd>設定されている場合は、この値に設定されているidentityでコードサインされる。デフォルトでは、環境変数CODE_SIGN_IDENTITYに使われている値を使用する。</dd> <dt>applehelp_codesign_flags</dt> <dd>設定されている場合は、この値のオプションをcodesignコマンドのオプションとして使用する。デフォルトでは環境変数OTHER_CODE_SIGN_FLAGSに使われている値を使用する。</dd> <dt>applehelp_codesign_path</dt> <dd>コマンドcodesignへのパスを変更するためにあるらしいが、使うことはないハズ。</dd> </dl> </div> <div class="section" id="id4"> <h3>リモートアクセス系の出力のオプション</h3> Apple Help Bookはネット経由でダウンロード出来たり、知識ベース(サポート掲示板を格好良くいう言葉らしい)へアクセスできるらしいが、使ったことはない。 <dl class="docutils"> <dt>applehelp_kb_product</dt> <dd>ナレッジベースへのURLの基本部分。デフォルトでは、’<project>-<release>’.</dd> <dt>applehelp_kb_url</dt> <dd>知識ベースへのURL</dd> <dt>applehelp_remote_url</dt> <dd>リモートコンテンツへのURL</dd> </dl> 多分、これからも使わないと思います。 </div> </div> <div class="section" id="id5"> <h2>参考資料とソースコード</h2> プロジェクトファイルはここに置いてきます。( <a class="reference download internal" href="https://www.mindto01s.com/_downloads/HalloWorld.zip" download="">HalloWorld.zip</a> ) <dl class="docutils"> <dt>使っている人はここの人ぐらいかも。</dt> <dd><a class="reference external" href="https://alastairs-place.net/blog/2015/01/14/apple-help-in-2015/">https://alastairs-place.net/blog/2015/01/14/apple-help-in-2015/</a></dd> <dt>Apple Help Book自体の解説はこちらを参考にしてください。</dt> <dd><a class="reference external" href="https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/user_help_concepts/apple_help_concepts.html">https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/ProvidingUserAssitAppleHelp/user_help_concepts/apple_help_concepts.html</a></dd> <dt>Apple Help Bookの構造自体はこちらの解説の方がわかりやすかったです。</dt> <dd><a class="reference external" href="http://devzone.touchdude.com/step-step-create-apple-help-your-cocoa-xcode-application">http://devzone.touchdude.com/step-step-create-apple-help-your-cocoa-xcode-application</a></dd> <dt>Sphinxの設定ファイルの書き方は本家が一番わかりやすいです。</dt> <dd><a class="reference external" href="http://www.sphinx-doc.org/ja/stable/config.html">http://www.sphinx-doc.org/ja/stable/config.html</a></dd> </dl> じゃあね。 </div> </article> <article> <h1>画面分割その2</h1> Fri, 05 Aug 2016 00:00:00 +0900 <h1>画面分割その2</h1> 第2回 MOSA自習室(<a class="reference external" href="http://mosa.connpass.com/event/36300/">http://mosa.connpass.com/event/36300/</a>)の発表用資料です。 説明が足らない部分は当日補足します。 <div class="section" id="id2"> <h2>画面分割の種類</h2> 画面分割(Splitting a window)には2種類あります。 <ol class="arabic simple"> <li>一つ目は、同一の書類の異なる部分を同時に見るための機能。プレインストールアプリではターミナルアプリのWindowが典型的な画面になります。</li> </ol> <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/terminal_app.png"></a> <ol class="arabic simple" start="2"> <li>二つ目は、iTunesやFinderのサイドバー等のMaster Detail構造のアプリです。</li> </ol> <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/finder_app.png"></a> ここでは、1の物を作ってみる。なお、NSSpliterViewは、おそらく2の物を作るために設計されたようです。2の型の分割を行うには素直にコーディングを行えば問題ありません。 </div> <div class="section" id="id3"> <h2>分割の追加&削除ボタンの作成</h2> スクロールバーにあるボタンの作り方だが、以前の「 <a class="reference internal" href="https://www.mindto01s.com/2014/11/03/b4ac3066_c9ed_467b_8613_9152e0a0678e.html">画面分割その1</a> 」でやったので説明はパス。 </div> <div class="section" id="id4"> <h2>分割の追加の方法</h2> 分割自体は簡単です。NSSplitViewControllerの以下のメソッドを呼んでいるだけです。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)insertSplitViewItem:(NSSplitViewItem *)splitViewItem atIndex:(NSInteger)index; </pre></div> </div> 問題は以下の2点です。 <ul class="simple"> <li>分割の追加後に分割されたviewが再レイアウトされて、分割線の位置がずれる。</li> <li>新規に分割後のスクロール位置が原点を指している。</li> </ul> 分割線の追加後に分割位置がずれる問題は、理想的な分割位置を計算して、以下のメソッドで再設定することで回避しています。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)setPosition:(CGFloat)position ofDividerAtIndex:(NSInteger)dividerIndex; </pre></div> </div> 理想的な分割位置は、「分割ボタンを押したNSScrollViewを2分割する位置」を理想と考えて計算しています。このようにすることで、ユーザーは「今このScrollViewが分割された」と認識しやすくなります。 同じく、スクロール位置の調整は、分割されたNSScrollViewのコンテンツが連続する位置に移動しています。 何もしないと、以下のようにスクロール位置が原点を示します。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/split_scrollpoint_1.png"></a> 調整することで、以下のようにコンテンツが連続する位置に調整しています。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/split_scrollpoint_2.png"></a> これも、ユーザーが分割を認識しやすくするために行っています。 </div> <div class="section" id="id5"> <h2>分割の削除の方法</h2> 分割の削除も簡単です。NSSplitViewControllerの以下のメソッドを呼んでいるだけです。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)removeSplitViewItem:(NSSplitViewItem *)splitViewItem; </pre></div> </div> 問題は以下の2点です。 <ul class="simple"> <li>分割の削除後にNSSplitViewが再レイアウトされて、分割線の位置がずれる。</li> <li>フォーカスがある(firstResponder)の分割部分が削除された場合に、フォーカスが未設定になる。</li> </ul> 分割線がずれる問題は、分割の追加と同じ手法で解決しています。ユーザーが分割したことを認識しやすいように、削除した分割部の1つ上の部分だけが広がったように見せています。 フォーカスの未設定への対処は、削除された分割部の1個上の分割部分へフォーカスを移動しています。 コードでは、[TVSSplitViewController makeFirstResponderAtIndex]を参照してください。 </div> <div class="section" id="id6"> <h2>分割線の移動方法</h2> NSSplitViewのサブクラスなので何もしないでも分割線( split bar )は移動できます。 が、デフォルトのままだと、分割線の移動時にコンテンツの中身と一緒に移動してしまいます。 これの何処が問題なのかは説明が難しいので、当日現場で説明します。 </div> <div class="section" id="id7"> <h2>理想と現実</h2> ここまで作ってみましたが、より良いユーザーインターフェイスとして以下のようなものがあります。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/better_splitView.png"></a> Inside Machintoshで紹介されている例です。ターミナルアプリにあるような分割の追加&削除ボタンは存在しません。スクロールバーに分轄用の黒い split bar が付いているだけです。この split bar をドラッグすると、スクロールバー上を split bar が移動し、マウスを離すとその位置で新たに画面が分轄されます。分轄部分を削除するには、 split bar をスクロールバーの端っこまで移動すると消えます。 この Inside Machintosh で紹介されている方式の方が、以下の2点で優れている。 <ul class="simple"> <li>画面上のコントロールが少ない。「ボタン2個 + split bar1個」から「split bar1個」に減っている。</li> <li>ユーザの作業が少ない。「分割後にsplit barの移動」から「split barの移動」だけに減っている。</li> </ul> この方式が劣っているのは、Appleの標準のアプリで採用している例が無いので、初見では操作方法が解りにくい事くらいと思われる。 あと、ソースコードはここ <a class="reference download internal" href="https://www.mindto01s.com/_downloads/TableViewSpliter.zip" download="">TableViewSpliter.zip</a> に置いときます。 次回は、こちらの方式を実装してみたいです。じゃあね。 </div> </article> <article> <h1>Cocoaにおける状態の保存と復元</h1> Sat, 30 Jul 2016 00:00:00 +0900 <h1>Cocoaにおける状態の保存と復元</h1> 単純な例では、カテゴリNSRestorableStateのrestorableStateKeyPathsで保存する変数のパスを返すだけ。 NSViewControllerのサブクラスにでも以下のようなコードを書けば良い。 <div class="highlight-objc notranslate"><div class="highlight"><pre>+ (NSArray *)restorableStateKeyPaths { return [@"color"];// 実際には[]の前に@がつく。コードパーサーがバグってるので@を外した } </pre></div> </div> これで、復帰時にプロパティcolorの内容が復元できる。 同じ動作をするものを、少し複雑に書くと。以下のようなコードになる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@property (atomic, copy) NSColor* color; . . . - (void) encodeRestorableStateWithCoder:(NSCoder *)coder { [super encodeRestorableStateWithCoder:coder]; NSData* theData=[NSArchiver archivedDataWithRootObject:self.color]; [coder encodeObject:theData forKey:@"color"]; } - (void) restoreStateWithCoder:(NSCoder *)coder { [super restoreStateWithCoder:coder]; NSData* theData = [coder decodeObjectForKey:@"color"]; if (theData != nil) { self.color =(NSColor *)[NSUnarchiver unarchiveObjectWithData:theData]; } } @synthesize color = _color; - (void) setColor:(NSColor*) inColor { @synchronized(self) { _color = [inColor copy]; } [self invalidateRestorableState]; } - (NSColor*) color { @synchronized(self) { return _color; } } </pre></div> </div> 初期設定Windowやパレットの復帰は、<a class="reference external" href="https://www.bignerdranch.com/blog/cocoa-ui-preservation-yall/">https://www.bignerdranch.com/blog/cocoa-ui-preservation-yall/</a> のコードが参考になる。 Document-Baseアプリケーションで、1個のドキュメントに複数のウインドウが開けるPhotoShopのようなアプリケーションの場合は以下のようになる。少し違うが、<a class="reference external" href="http://mikeabdullah.net/lion-restore-multi-window-document.html">http://mikeabdullah.net/lion-restore-multi-window-document.html</a> も参考になる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)restoreDocumentWindowWithIdentifier:(NSString *)identifier state:(NSCoder *)state completionHandler:(void (^)(NSWindow *, NSError *))completionHandler { NSWindowController* theWindowController; theWindowController = [self makeWindowController]; completionHandler([theWindowController window], nil); } - (NSWindowController*) makeWindowController { NSStoryboard* theStoryboard; NSWindowController* theWindowController; theStoryboard = [NSStoryboard storyboardWithName:@"Document" bundle:nil]; theWindowController = [theStoryboard instantiateInitialController]; [self addWindowController:theWindowController]; return theWindowController; } </pre></div> </div> ここまでは、アップルのドキュメントなどの通り。 Windowは動的に増える事を前提にしているので、restoreDocumentWindowWithIdentifier:〜なメソッドが用意されていた。 NSTabViewのタブやNSSplitViewのsplitが動的に増える場合にはどうするか？ これは、基本に戻り、encodeRestorableStateWithCoder:やrestoreStateWithCoder:のメソッドをオーバーライドする事になる。 <div class="highlight-sh notranslate"><div class="highlight"><pre>- (void) encodeRestorableStateWithCoder:(NSCoder *)coder { [super encodeRestorableStateWithCoder:coder]; NSMutableArray* theArray = [NSMutableArray array]; for(NSInteger i = 0; i <= [self countOfDivider]; i++) { CGFloat thePosition = [self positionOfDividerAtIndex:i]; [theArray addObject:@(thePosition)]; } [coder encodeObject:theArray forKey:@"splitSizes"]; } - (void) restoreStateWithCoder:(NSCoder *)coder { [super restoreStateWithCoder:coder]; NSArray* theSplitSizes = [coder decodeObjectForKey:@"splitSizes"]; // 個数分分割して NSInteger theSplitCount = theSplitSizes.count; while(theSplitCount) { [self addLastSplitItem:nil]; theSplitCount--; } // 幅を揃える for(NSInteger i = 0; i < [self countOfDivider]; i++) { CGFloat thePosition = [[theSplitSizes objectAtIndex:i] floatValue]; [self.splitView setPosition:thePosition ofDividerAtIndex:i]; } } - (IBAction) addLastSplitItem:(id)sender { NSStoryboard* theStoryboard; NSViewController* theViewController; NSSplitViewItem* theItem; theStoryboard = [NSStoryboard storyboardWithName:@"MainViewController" bundle:nil]; theViewController = [theStoryboard instantiateInitialController]; theItem = [NSSplitViewItem splitViewItemWithViewController:theViewController]; [self addSplitViewItem:theItem]; [self invalidateRestorableState]; } - (NSInteger) countOfDivider { NSInteger theCount = self.splitViewItems.count; return (theCount == 0 ) ? 0 : theCount - 1; } - (void)setPosition:(CGFloat)position ofDividerAtIndex:(NSInteger)dividerIndex { NSAssert( dividerIndex >= 0, nil); NSAssert( dividerIndex < [self countOfDivider], nil); [self.splitView setPosition:position ofDividerAtIndex:dividerIndex]; } - (CGFloat)positionOfDividerAtIndex:(NSInteger)dividerIndex { NSAssert( dividerIndex >= 0, nil); NSAssert( dividerIndex <= [self countOfDivider], nil); CGFloat thePosition = 0; for(NSInteger i = 0; i <= dividerIndex; i++) { NSSplitViewItem* theItem = [self.splitViewItems objectAtIndex:i]; NSRect theFrame = theItem.viewController.view.frame; thePosition += theFrame.size.height; // 2個目のitem以降にはdividerThicknessを含める if( i != 0) { thePosition += self.splitView.dividerThickness; } } return thePosition; } </pre></div> </div> じゃあね。 </article> <article> <h1>キーボードショートカットキーの拡張</h1> Sun, 24 Jul 2016 00:00:00 +0900 <h1>キーボードショートカットキーの拡張</h1> MacOSの⌘キーを使ったショートカットシステムに、擬似モードの概念を取り入れる事でショートカットキーの機能を拡張する方法を考えてみる。 擬似モードとは、モディファイアキー(⌘とか)を押している時と離している時をそれぞれ別の動作として考えるUIの手法です。詳細はジェフラスキンのswyftyの記事を参考にしてください。 MacOSに以下の条件で擬似モードを追加する方法を考えました。 <ol class="arabic simple"> <li>追加のハードウエアが不要</li> <li>既存のUIの動作を妨害しない</li> <li>GUIとして学習が容易。</li> </ol> で、実装として以下のような機能にしました。 <ol class="arabic simple"> <li>⌘キー+英字キーの組み合わせて、擬似モードに入る。</li> <li>⌘キーを離したら、擬似モードを抜ける。</li> <li>擬似モード中に、英数キーを押すことで、firstResponderへキーに結び付けられたアクションを発行する。</li> <li>擬似モードに入ると、Panelを表示する。Panelには使用可能なアクションの一覧が表示される。</li> </ol> リッチテキストの編集機能を試しに実装してみました。 ⌘Tを押すと、以下のようなPanelが表示される。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/cmdKeyMode.png"></a> ⌘キーを押したまま、L,R,C,Jのアルファベットキーを押すと、選択された行のアライメントが変更される。 ⌘を離すと、擬似モードを抜けるのでPanelの表示は消える。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/cmdKeyMode_2.png"></a> ムービーで動作確認したほうが早いかも( <a class="reference download internal" href="https://www.mindto01s.com/_downloads/cmdkeymode.mov" download="">cmdkeymode.mov</a> ) で、これを実装すると以下のような利点と欠点がある。 <ol class="arabic simple"> <li>ショートカットが多段階になるので使えるキーが事実上増える</li> <li>emacsスタイルのショートカットと比べてGUIの表示がある事と⌘を使うことで学習コストが低い</li> <li>Panelの陰にアクションを投げる対象物が隠れてしまう。</li> <li>擬似モード中だけに使えるショートカットキーというのは理解しづらいかもしれない</li> </ol> 今の所、こんな感じかな。プロジェクトファイルはここに置いてきます。( <a class="reference download internal" href="https://www.mindto01s.com/_downloads/commandKeyMode.zip" download="">commandKeyMode.zip</a> ) じゃあね。 </article> <article> <h1>xibファイルの中のオブジェクト図</h1> Mon, 11 Jul 2016 00:00:00 +0900 <h1>xibファイルの中のオブジェクト図</h1> xibファイルの中にある、それぞれのオブジェクトの関係を図示したい。 xibから自動生成させるのが理想だが、実力がないので出来なかった。テキストから画像を生成させるところまでをメモとしてまとめた。 このようなテキストから <div class="highlight-sh notranslate"><div class="highlight"><pre>digraph window { // 定義ファイルをインクルード include(objectGraph.inc) // オブジェクトの設定 GenericObject(WinController) WindowObject(Window) // コネクションの設定 IBOutlet(Window, WinController, "delegate") IBOutlet(WinController, Window, "window") // 表示上の調整 {rank=same; WinController; Window;} } </pre></div> </div> 以下のような図を生成する。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/window.png"></a> 材料は、 <ul class="simple"> <li>graphviz</li> <li>icon画像</li> <li>m4</li> </ul> の3つ。dot言語をm4マクロで包んで、簡単な表記でオブジェクト図を描画できるようにした。 手順は、 <ol class="arabic simple"> <li>ディレクトリ構造を整え、icon画像を配置。</li> </ol> zipファイルの中身を以下の様に配置する。<a class="reference download internal" href="https://www.mindto01s.com/_downloads/objectGraph.zip" download="">objectGraph.zip</a> <div class="highlight-sh notranslate"><div class="highlight"><pre>$ tree . . ├── icon │ ├── FirstResponder.png │ ├── NSApplication.png │ ├── NSCell.png │ ├── NSControl.png │ ├── NSObject.png │ ├── NSObjectController.png │ ├── NSView.png │ ├── NSViewController.png │ ├── NSWindow.png │ ├── NSWindowController.png │ └── Placeholder.png └── objectGraph.inc </pre></div> </div> <ol class="arabic simple" start="2"> <li>描画するオブジェクトのdot.m4ファイルを書く。</li> </ol> 上記のファイルを展開したディレクトリに、テキストファイルを書く。 <ol class="arabic simple" start="3"> <li>コマンド実行。</li> </ol> <div class="highlight-sh notranslate"><div class="highlight"><pre>$ m4 -DshowIBOutlet window.dot.m4 | dot -T png -o window.png </pre></div> </div> <div class="section" id="iboutlet"> <h2>サンプル1 IBOutlet</h2> 以下の様なファイルを <div class="highlight-sh notranslate"><div class="highlight"><pre>digraph objectGraph { // 定義ファイルをインクルード include(objectGraph.inc) // オブジェクトの設定 ApplicationObject(NSApplication) GenericObject(CCAppDelegate) WindowObject(NSWindow, , viewGroup) // View階層の設定 BeginContainerView(contentsView, NSView, , viewGroup) ControlObject(NSButton1) ControlObject(NSTextField1) ControlObject(NSTextField2) EndContainerView // コネクションの設定 IBOutlet(NSApplication, CCAppDelegate, " delegate") IBOutlet(CCAppDelegate, NSWindow, "window") IBOutlet(CCAppDelegate, NSTextField1, "yen") IBOutlet(CCAppDelegate, NSTextField2, "doller") IBOutlet(NSWindow, contentsView, " contentsView") IBAction(NSButton1, CCAppDelegate, "target/convert:") // 表示上の調整 {rank=same; CCAppDelegate; NSWindow;} } </pre></div> </div> 以下のコマンドで画像を生成すると、 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ m4 -DshowIBOutlet CurrencyConverter.dot.m4 | dot -T png -o CurrencyConverter_outlet.png </pre></div> </div> outletを表示します。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/CurrencyConverter_outlet.png"></a> m4に”showIBOutlet”を渡すと、outletを表示します。 </div> <div class="section" id="ibaction"> <h2>サンプル2 IBAction</h2> サンプル1と同じテキストファイルを以下のコマンドで画像生成すると、 以下のコマンドで画像を生成すると、 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ m4 -DshowIBAction CurrencyConverter.dot.m4 | dot -T png -o CurrencyConverter_action.png </pre></div> </div> actionを表示します。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/CurrencyConverter_action.png"></a> m4に”showIBAction”を渡すと、outletを表示します。 IBActionのラベルは”target/セレクタ名”にしています。 </div> <div class="section" id="view"> <h2>サンプル3 View階層</h2> View階層を表現するのには、矢印などのコネクションの表現だけでは無理だと思われるので、”内包”の表現を使用する様にした。 <div class="highlight-sh notranslate"><div class="highlight"><pre>digraph objectGraph { // 定義ファイルをインクルード include(objectGraph.inc) // View階層の設定 BeginContainerView(contentsView, NSView, , viewGroup) ControlObject(NSButton1) ControlObject(NSTextField1) ControlObject(NSTextField2) EndContainerView } </pre></div> </div> は、contentsViewに2つのテキストフィールドと1つのボタンを配置されていることを示しています。 以下のコマンドで画像を生成すると、 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ m4 CurrencyConverter_view.dot.m4 | dot -T png -o CurrencyConverter_view.png </pre></div> </div> こんな感じになります。グレーの枠で複数のコントロールがcontentsViewに内包されていることを示しています。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/CurrencyConverter_view.png"></a> </div> <div class="section" id="id1"> <h2>サンプル4 少し大きな画像</h2> ある程度オブジェクトの数が増えると、実用的ではないかもしれない。 ここ( <a class="reference external" href="./objectGraph.dot.m4">objectGraph.dot.m4</a> )にあるようなファイルを出力するだけで、 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/objectGraph.png"></a> こんな煩雑な画像が出てくる。 初心者に説明するための、Object図ならば簡単に書けるけど、実用的なアプリケーションのオブジェクト図は、煩雑すぎて実用にはならないかもしれない。 </div> <div class="section" id="id2"> <h2>試作してみての感想</h2> 利点としては、 <ul class="simple"> <li>元データがテキストなので各種コマンドラインツールと相性が良い。</li> <li>outletとactionを1つのデータから出力できる様にしたので、画像が煩雑になるのを防いでいる。</li> </ul> 欠点は、 - m4のマクロだけでは、テキスト入力の手間はあまり変わらない。 - ある程度大きなオブジェクト図になるとかなり煩雑な画面になってしまう。 今後の展開として <ul class="simple"> <li>xibから出力できる様にしたい。</li> <li>bindingの表記も必要</li> <li>autoLayoutの表記も必要</li> <li>注目するObjectをフィルタリングして出力可能にすると良いかもしれない</li> </ul> </div> </article> <article> <h1>Swyftのユーザーインターフェイス　その3</h1> Mon, 11 Jan 2016 00:00:00 +0900 <h1>Swyftのユーザーインターフェイス　その3</h1> クラスメソッドさんの会議室をお借りして、<a class="reference external" href="http://connpass.com/event/24210/?utm_campaign=event_participate_cancel_to_owner&utm_source=notifications&utm_medium=email&utm_content=title_link">第76回Cocoa勉強会関東</a> を開催しました。 そこで、「Swyftのユーザーインターフェイス」の発表を行いました。 内容は、 <ul class="simple"> <li>SwyftUIとは何かの説明</li> <li>MacOSXでSwiftyUI(のサブセット)を実現するアプリケーションの解説</li> <li>SwyftUIで使用する、キーボードの自作</li> </ul> なお、かな英数キーをLeapキーの代わりに使用しているので、JISキーボードであれば自作しなくともソフトウエアは使用できます。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/TestTextEdit.zip" download="">TestTextEdit.zip</a> に、pdfファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/SwyftUI.pdf" download="">SwyftUI.pdf</a> に置いておきます。 </article> <article> <h1>Swyftのユーザーインターフェイス　その2</h1> Sun, 03 Jan 2016 00:00:00 +0900 <h1>Swyftのユーザーインターフェイス　その2</h1> コードを書く前に、LEAPキーの状態遷移を書き出してみる。 <div class="section" id="id1"> <h2>まずはイベントの種類</h2> <table border="1" class="colwidths-given docutils" id="id4"> <caption>イベントの種類</caption> <colgroup> <col width="25%"/> <col width="75%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">イベント名</th> <th class="head">説明</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>LF下</td> <td>LEAP Forward keyDown event</td> </tr> <tr class="row-odd"><td>LF上</td> <td>LEAP Forward keyUp event</td> </tr> <tr class="row-even"><td>LB下</td> <td>LEAP Back keyDown event</td> </tr> <tr class="row-odd"><td>LB上</td> <td>LEAP Back keyUp event</td> </tr> <tr class="row-even"><td>Tab下</td> <td>Tab keyDown event</td> </tr> <tr class="row-odd"><td>Tab上</td> <td>Tab keyUp event</td> </tr> <tr class="row-even"><td>その他</td> <td>その他のキーイベント</td> </tr> </tbody> </table> SwyftではLeapキーを押している間だけ検索する。そのため、keyDownとKeyUpを区別する必要があり、keyDownイベントとkeyUpの2つのイベントを分けている。 TabキーはLeapキーとの組み合わせで再検索を行うためにイベントを追加した。 </div> <div class="section" id="id2"> <h2>次に状態の種類</h2> <table border="1" class="colwidths-given docutils" id="id5"> <caption>状態の種類</caption> <colgroup> <col width="25%"/> <col width="75%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">状態名</th> <th class="head">説明</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>normal</td> <td>通常状態。各種キー入力はそのままTextViewへ渡される</td> </tr> <tr class="row-odd"><td>findF</td> <td>前方検索状態。各種キー入力された文字列が検索文字列として前方逐次検索される</td> </tr> <tr class="row-even"><td>findB</td> <td>後方検索状態。各種キー入力された文字列が検索文字列として後方逐次検索される</td> </tr> <tr class="row-odd"><td>select</td> <td>選択状態。現在のカーソル位置とマークされた位置を選択状態にする。</td> </tr> </tbody> </table> </div> <div class="section" id="id3"> <h2>状態遷移図を書くとこんな感じ。</h2> "findF" [ label = "LF下" ]; "normal" -> "findB" [ label = "LB下" ]; "normal" -> "normal" [ label = "その他" ]; "findF" -> "select" [ label = "LB下" ]; "findF" -> "normal" [ label = "LF上" ]; "findF" -> "findF" [ label = "その他" ]; "findB" -> "select" [ label = "LF下" ]; "findB" -> "normal" [ label = "LB上" ]; "findB" -> "findB" [ label = "その他" ]; "select" -> "findF" [ label = "LB上" ]; "select" -> "findB" [ label = "LF上" ]; "select" -> "select" [ label = "その他" ]; }"/> 眠いから、状態遷移表はまた次に書く。 </div> </article> <article> <h1>Swyftのユーザーインターフェイス　その1</h1> Sat, 02 Jan 2016 00:00:00 +0900 <h1>Swyftのユーザーインターフェイス　その1</h1> <div class="section" id="swyft"> <h2>Swyftとはなんぞや？</h2> Swiftではない。 Swyftは、ジェフ・ラスキンによって開発されたテキスト編集用のユーザーインターフェイスです。 Leapキーと呼ばれる2つのキーを使用した、逐次検索を主体とした操作体系が特徴です。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/Canon_Cat.jpg"></a> こんな画像のようなキーボードで操作します。(ウィキペディアのCanonCatより) もちろん私は使ったことはない。以下の文献を元に使用感を想像するだけ。 以下の文献をふんわりと心の目で見て妄想する。 <ul class="simple"> <li><a class="reference external" href="http://www.amazon.co.jp/dp/4894714205">「ヒューメイン・インタフェース――人に優しいシステムへの新たな指針」</a></li> </ul> ジェフ・ラスキン本人がSwyftについて解説している。第5章「統一化」で、Swyft特有のキーボード操作について解説している。 <ul class="simple"> <li><a class="reference external" href="http://www.sweetpie.com/appleii/diy.html">「SwyftWareを使おう」</a></li> </ul> AppleII用のソフトウェアSwyftWareの使用レポート。日本語でSwyftの雰囲気がわかる貴重な文献です。私にとっては、「ヒューメイン・インタフェース」より解りやすかった。 <ul class="simple"> <li><a class="reference external" href="https://www.youtube.com/watch?v=o_TlE_U_X3c">CanonCatの販促ビデオ</a></li> </ul> SwyftのUIを採用している、CanonCatの雰囲気がわかる。キー操作と画面の関係はこの動画を見ると腑に落ちる感じ。 そして、冬休みの工作の時間が始まる。 </div> <div class="section" id="leap"> <h2>LEAPキーがないから作る</h2> まずは、Leapキーがあるキーボードをデッチ上がる必要がある。 で、コレ。冬休みの工作としては良くできた。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/IMG_1997.jpg"></a> HHKと <a class="reference external" href="http://www.omiya-giken.com/?page_id=431">英数/かなキーボード</a> を2個位置しただけ。英数/かなキーボードは、基盤だけ自作の傾斜台に釘で打ち付けた。 スペースキーの前にキーを置くのは想像以上に打ちやすい。ただし、キーボードの配置そのものよりもキーの高さが打ちやすさに関係していると思われる。 スペースキーを押したときの高さよりも、Leapキーの高さが低い必要がある。そうしないと、スペースキーを押したときにLeapキーを誤って押してしまうことがあった。 </div> <div class="section" id="id3"> <h2>LEAPキーの検索を日本語対応させる</h2> 逐次検索を主体としたUIなのに、日本語ではかな漢字変換が間に入るために、操作性が低下してしまう。この問題の解決はすでに先人が解決していて、 逐次検索を行うには、 <a class="reference external" href="http://0xcc.net/migemo/">migemo</a> を使用する。で解決。 以前、OSX内蔵の辞書を使ったmigemoもどきを作ったが、非公開APIを使った実装になってしまったので、素直に <a class="reference external" href="https://github.com/koron/cmigemo">C/migemo</a> を使うことにした。 が、なんか上手く行かない。 </div> <div class="section" id="id4"> <h2>LEAPキーを押したときだけ、検索をするようにする</h2> Leapキーを使った操作系なのだが、これもまだ上手く行かない。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss1.png"></a> 右上のパレットは、Leapキーと関連するキーの状態を表している。 <div class="highlight-objc notranslate"><div class="highlight"><pre>[NSEvent addLocalMonitorForEventsMatchingMask: handler:] </pre></div> </div> を使って、キーの変更を捉えている。 今日は、ここまで。 </div> </article> <article> <h1>BDRuleEngine</h1> Sun, 24 May 2015 00:00:00 +0900 <h1>BDRuleEngine</h1> BDRuleEngineは以下のサイトで配布しているルールエンジン。 <a class="reference external" href="http://eschatologist.net/bDistributed.com/">http://eschatologist.net/bDistributed.com/</a> 10年以上前にObjective-Cで書かれた。WebObjectsのDirectToWebのルールエンジンを再実装したものらしい。前々回のCocoa勉強会で手直ししたものを発表したので、zipでまとめておく。 手直しの内容は、 <ul class="simple"> <li>BDQualifier was replaced by NSPredicate.</li> <li>BDSortOrdering was replaced by NSSortDescriptor.</li> <li>BDControl was replaced by cocoa binding.</li> <li>Adds BDExpressionAssignment class.</li> </ul> プロジェクトファイルは以下からダウンロードできる。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/BDRuleEngine.zip" download="">BDRuleEngine.zip</a> <a class="reference download internal" href="https://www.mindto01s.com/_downloads/BDRuleEditor.zip" download="">BDRuleEditor.zip</a> </article> <article> <h1>初期設定Windowの作り方</h1> Fri, 06 Mar 2015 00:00:00 +0900 <h1>初期設定Windowの作り方</h1> 勉強会資料。初期設定Windowの作り方。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/PrefWindow.png"></a> プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/PrefWindow.zip" download="">PrefWindow.zip</a> に、pdfファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/PrefWindow.pdf" download="">PrefWindow.pdf</a> に置いておきます。 </article> <article> <h1>インスペクタパネルの設計と実装</h1> Sat, 13 Dec 2014 00:00:00 +0900 <h1>インスペクタパネルの設計と実装</h1> 勉強会資料。インスペクターパネルを複数同時に表示できるようにした。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/inspector.png"></a> プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/inspector.zip" download="">inspector.zip</a> に置いておきます。 </article> <article> <h1>画面分割その1</h1> Mon, 03 Nov 2014 00:00:00 +0900 <h1>画面分割その1</h1> 昔から作ろうとしていて、挫折していた画面分割のUIを作ることにした。 以前は、汎用性を考慮した設計にしようと努力して失敗したので、今回は努力しない方針とする。 まずは、NSScrollerにボタンをつける。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/split1.png"></a> 垂直スクロールバーの上の方にある。2つのアイコンがそれ。 コードはこんな感じ。 TDScrollView.h <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface TDScrollView : NSScrollView @end </pre></div> </div> TDScrollView.m <div class="highlight-objc notranslate"><div class="highlight"><pre>#import "TDScrollView.h" @interface TDScrollView () @property (strong) NSButton* vSplitOpenButton; @property (strong) NSButton* vSplitCloseButton; @end @implementation TDScrollView - (IBAction) responseOpenSplit:(id)sender { id theObject = [NSApp targetForAction:@selector(openSplit:) to:self from:self]; if(theObject && theObject != self) { [NSApp sendAction:@selector(openSplit:) to:theObject from:self]; } } - (IBAction) responseCloseSplit:(id)sender { id theObject = [NSApp targetForAction:@selector(closeSplit:) to:self from:self]; if(theObject && theObject != self) { [NSApp sendAction:@selector(closeSplit:) to:theObject from:self]; } } - (void)tile { [super tile]; if( self.hasVerticalScroller) { NSScroller* vScroller = self.verticalScroller; NSRect vScrollerFrame = vScroller.frame; // 分割ボタン if( !self.vSplitOpenButton ) { self.vSplitOpenButton = [[NSButton alloc] initWithFrame: NSZeroRect]; self.vSplitOpenButton.buttonType = NSMomentaryLightButton; self.vSplitOpenButton.bezelStyle = NSThickSquareBezelStyle; self.vSplitOpenButton.bordered = NO; self.vSplitOpenButton.image = [NSImage imageNamed: @"splitopen"]; self.vSplitOpenButton.imagePosition = NSImageOnly; [self.vSplitOpenButton.cell setImageScaling:NSImageScaleProportionallyDown]; self.vSplitOpenButton.target = self; self.vSplitOpenButton.action = @selector(responseOpenSplit:); [self addSubview:self.vSplitOpenButton]; } NSButton* vOpenButton = self.vSplitOpenButton; NSRect vOpenButtonFrame; // 分割ボタンの位置を設定 vOpenButtonFrame.origin.x = vScrollerFrame.origin.x; vOpenButtonFrame.origin.y = vScrollerFrame.origin.y; vOpenButtonFrame.size.height = vScrollerFrame.size.width; vOpenButtonFrame.size.width = vScrollerFrame.size.width; vOpenButton.frame = vOpenButtonFrame; // スクローラーの表示非表示を同期する vOpenButton.hidden = vScroller.hidden; // 結合ボタン if( !self.vSplitCloseButton ) { self.vSplitCloseButton = [[NSButton alloc] initWithFrame: NSZeroRect]; self.vSplitCloseButton.buttonType = NSMomentaryLightButton; self.vSplitCloseButton.bezelStyle = NSThickSquareBezelStyle; self.vSplitCloseButton.bordered = NO; self.vSplitCloseButton.image = [NSImage imageNamed: @"splitclose"]; self.vSplitCloseButton.imagePosition = NSImageOnly; [self.vSplitCloseButton.cell setImageScaling:NSImageScaleProportionallyDown]; self.vSplitCloseButton.target = self; self.vSplitCloseButton.action = @selector(responseCloseSplit:); [self addSubview:self.vSplitCloseButton]; } NSButton* vCloseButton = self.vSplitCloseButton; NSRect vCloseButtonFrame; // 結合ボタンの位置を設定 vCloseButtonFrame.origin.x = vScrollerFrame.origin.x; vCloseButtonFrame.origin.y = vScrollerFrame.origin.y + vOpenButtonFrame.size.height; vCloseButtonFrame.size.height = vScrollerFrame.size.width; vCloseButtonFrame.size.width = vScrollerFrame.size.width; vCloseButton.frame = vCloseButtonFrame; // スクローラーの表示非表示を同期する vCloseButton.hidden = vScroller.hidden; // スクロールバーの大きさをボタンに合わせて調整 vScrollerFrame.origin.y += vOpenButtonFrame.size.height + vCloseButtonFrame.size.height; vScrollerFrame.size.height -= vOpenButtonFrame.size.height + vCloseButtonFrame.size.height; [vScroller setFrame:vScrollerFrame]; } } @end </pre></div> </div> tileメソッドをオーバーライドしないと実装できない。 IBでなんとかしようとしたり、サブクラスしないでなんんとかできると考えてはいけない。 </article> <article> <h1>第68回 Cocoa勉強会関東 - Mac/iOS開発勉強会の告知</h1> Wed, 27 Aug 2014 00:00:00 +0900 <h1>第68回 Cocoa勉強会関東 - Mac/iOS開発勉強会の告知</h1> Cocoa勉強会関東( <a class="reference external" href="http://cocoa-study.com">http://cocoa-study.com</a> )の68回目の勉強会です。 見学の方は以下のページで参加表明してください。 <a class="reference external" href="http://connpass.com/event/8287/">http://connpass.com/event/8287/</a> ※勉強会のメンバーの方はこちらに登録してもかまいませんが、いつものところでも出席登録してください。 日時：20014/9/27(土)　13:00-17:00 集合：現地 会場：千葉県松戸市本町20-10 ルシーナビル7F “FAN CLUB” <blockquote> <div>JR常磐線／新京成線松戸駅から徒歩2分 <a class="reference external" href="http://madcity.jp/fanclub/">http://madcity.jp/fanclub/</a> </div></blockquote> 参加費：500円（当日集めます） 発表： Cocoa勉強会関東について Mac OS X, iOSでのプログラミングについての勉強会です。 4-6本程度の発表と質疑応答、その他雑談という構成です。 Mac/iOSの比重はその日によって変わります。Macばかりの日もあります。 最近の内容については、 <a class="reference external" href="http://wp.cocoa-study.com">http://wp.cocoa-study.com</a> を参照ください。 勉強会を見学された方で入会を希望される方は、<a class="reference external" href="http://www.cocoa-study.com/mail/">http://www.cocoa-study.com/mail/</a> から、ご連絡ください。 じゃあね。 </article> <article> <h1>swiftのローカルスコープ</h1> Sun, 15 Jun 2014 00:00:00 +0900 <h1>swiftのローカルスコープ</h1> 色々と試して出来ないのかと、諦めていた。が、ググると stackOverFlowのサイトに答が有った。 <a class="reference external" href="http://stackoverflow.com/questions/24011271/how-to-create-local-scopes-in-swift">http://stackoverflow.com/questions/24011271/how-to-create-local-scopes-in-swift</a> こーやって、locallyを定義すると。 <div class="highlight-objc notranslate"><div class="highlight"><pre>func locally(work: () -> ()) { work() } </pre></div> </div> こんな風に、使える。 <div class="highlight-objc notranslate"><div class="highlight"><pre>locally { let g = 42 println(g) } </pre></div> </div> swiftでは引数の最後の引数は括弧の外にだしても良いようだ。 色々と、試してみるとこんな感じ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>func local(test:Int, inWork:()->()) { inWork(); } // OK local(12, { }) // OK local(12){ } // Error local(12) { } </pre></div> </div> 3番目の例が文法的に許さないのは、単純なローカルスコープと引数の区別が出来ないのかも知れない。 swiftでは@synchronizedはサポートが無いそうなので、このローカルスコープを作る方法を利用出来そうだと思った。が、これもまた、ググると stackOverFlowのサイトに答が有った。 <a class="reference external" href="http://stackoverflow.com/questions/24045895/what-is-the-swift-equivalent-to-objective-cs-synchronized">http://stackoverflow.com/questions/24045895/what-is-the-swift-equivalent-to-objective-cs-synchronized</a> <div class="highlight-objc notranslate"><div class="highlight"><pre>func synced(lock: AnyObject, closure: () -> ()) { objc_sync_enter(lock) closure() objc_sync_exit(lock) } synced(self) { println("This is a synchronized closure") } </pre></div> </div> この、クロージャーを受け取って、その前後で定型処理を行うのは結構つかえるテクニックに見える。例えば、 <div class="highlight-objc notranslate"><div class="highlight"><pre>func cgLoclaContext(closure: () -> ()) { var theContext: CGContext; CGContextSaveGState(theContext) closure() CGContextRestoreGState(theContext) } cgLoclaContext() { // ココで、描画色を変えたり、クリッピングリージョンを変えたりする。 } // ここまでくると、CGContextの状態が自動で戻る。 </pre></div> </div> ローカルスコープと、CoreGraphixの状態を一致させる事で状態の戻し忘れ等のミスを防げそう。 </article> <article> <h1>IB_DESIGNABLEとIBInspectable</h1> Sun, 08 Jun 2014 00:00:00 +0900 <h1>IB_DESIGNABLEとIBInspectable</h1> XCodeでInterfaceBuilderようの新たなキーワードが定義された。定義されたのはIB_DESIGNABLEとIBInspectableの2つ。 <table border="1" class="docutils"> <colgroup> <col width="50%"/> <col width="50%"/> </colgroup> <tbody valign="top"> <tr class="row-odd"><td>IB_DESIGNABLE</td> <td>編集可能にしたいクラスに付ける</td> </tr> <tr class="row-even"><td>IBInspectable</td> <td>編集可能にしたいプロパティに付ける</td> </tr> </tbody> </table> IB_DESIGNABLEは以下のように@interfaceの前に付ける。 <div class="highlight-objc notranslate"><div class="highlight"><pre>IB_DESIGNABLE @interface CustomView : NSView . . . </pre></div> </div> IBにこのクラスが編集可能である事を知らせる為だけのキーワードらしい。 一方、IBInspectableは少し複雑。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface CustomView : NSView @property (nonatomic) IBInspectable NSColor* fillColor; @property (nonatomic) IBInspectable NSPoint point; @property (nonatomic) IBInspectable NSRect rect; @property (nonatomic) IBInspectable NSString* string; @property (nonatomic) IBInspectable BOOL thisIsBool; @property (nonatomic) IBInspectable NSImage* thisIsImage; @property (nonatomic) IBInspectable NSInteger intgerValue; @property (nonatomic) IBInspectable float floatValue; @property (nonatomic) IBInspectable double doubleValue; . . . </pre></div> </div> 上記のように型名の前にIBOutletのように付ける。そうするとIB側が適当にインスペクターに表示してくれる。 NSImageやNSColorはiOSではUIImageやUIColorになると思われる。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/IBInspectable.png"></a> </div></blockquote> 使える、型は決まっているようで物は使えなかった。 <div class="highlight-objc notranslate"><div class="highlight"><pre>// Number型は表示出来ない //@property (nonatomic) IBInspectable NSNumber* number; // NSRangeは表示出来ない //@property (nonatomic) IBInspectable NSRange range; // NSValueは表示出来ない //@property (nonatomic) IBInspectable NSValue* thisIsNSValue; // 列挙は表示出来ない //@property (nonatomic) IBInspectable TEST_ENUM updateType; </pre></div> </div> NSRangeが出来ないのは意外だが、IB上ではあまり使い道が無いのかもしれない。贅沢を言えば、角度を表すUIに対応する型や、列挙型をサポートして欲しかった。 多分、”User defined Runtime Attributes”の機能をソースコードをパースして自動化出来るようにした物なんだろう。 “User defined Runtime Attributes”を表示するとリアルタイムで値が変わっている。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/UserDefinedRuntimeAttributes.png"></a> </div></blockquote> 昔のIBPluginとは違った方向で作っているので、NSCoderとか無関係に実装出来ている。 IBでプレビューするには、framework化した上に、同じプロジェクトでコンパイルする必要がある等の面倒な面が有った。 </article> <article> <h1>日本語のmanは便利だ</h1> Fri, 11 Apr 2014 00:00:00 +0900 <h1>日本語のmanは便利だ</h1> ここ jmanを使わずにMacのmanを日本語化する方法 ( <a class="reference external" href="http://tukaikta.blog135.fc2.com/blog-entry-224.html">http://tukaikta.blog135.fc2.com/blog-entry-224.html</a> ) を参考に環境整備した。 コチラの環境は MacPorts の為か、man がうまく jman を探してくれない。 仕方ないので .bash_profileに以下の行を追加した。 <div class="highlight-bash notranslate"><div class="highlight"><pre>alias jman='env LANG=ja_JP.UTF-8 man -M /usr/local/share/man/: ' </pre></div> </div> 今までやせ我慢してたんだな。 </article> <article> <h1>NSSplitViewの同期</h1> Sat, 11 Jan 2014 00:00:00 +0900 <h1>NSSplitViewの同期</h1> ２つのNSSplitViewでSpliterPaneの位置を同期させたい。splitViewDidResizeSubviews:を使えば出来そうだと思いコードを書いてみた。 こんな感じ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)splitViewDidResizeSubviews:(NSNotification *)notification { NSSplitView* theCurrentSplitView = (NSSplitView *)notification.object; NSView* theParentView = [theCurrentSplitView superview]; NSArray* theParentSubviews = [theParentView subviews]; NSArray* theSrcArray; theSrcArray = theCurrentSplitView.subviews; for(NSView* theDstSplitView in theParentSubviews) { if( theDstSplitView != theCurrentSplitView && [theDstSplitView isKindOfClass:[NSSplitView class]] ) { NSArray* theDstArray; theDstArray = theDstSplitView.subviews; if( theSrcArray.count == theDstArray.count ) { NSInteger theCount = theDstArray.count; for(NSInteger i = 0; i < theCount; i++) { ((NSView*)theDstArray[i]).frame = ((NSView*)theSrcArray[i]).frame; } } } } } </pre></div> </div> リサイズするとうまく動いてくれない。さて、どうした物か。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/SplitViewTest1.zip" download="">SplitViewTest1.zip</a> に置いておきます。 </article> <article> <h1>ヒレガス本 20章課題</h1> Fri, 27 Dec 2013 00:00:00 +0900 <h1>ヒレガス本 20章課題</h1> 20章の課題は以下の２つ。 <ol class="arabic simple"> <li>BigLetterViewの文字にNSShadowを使って影を付ける。</li> <li>BigLetterViewのの文字にboldやitalicの効果を付けるチェックボックスをつける。</li> </ol> 最初の課題は簡単です。メソッドprepareAttributesの末尾にNSShadowに関するコードを追加するだけ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) prepareAttributes { . . . NSShadow* theShadow = [[NSShadow alloc] init]; theShadow.shadowOffset = NSMakeSize(3.0, -3.0); self.attributes[NSShadowAttributeName] = theShadow; } </pre></div> </div> 二番目の課題も簡単。以下の手順で実装する。 <ul class="simple"> <li>BigLetterViewにboldやitalicのプロパティを追加</li> <li>アクセッサメソッドで、attributesのNSFontAttributeNameキーの値を更新</li> <li>UIはbindingで作成</li> </ul> ヘッダファイルの追加は２行だけ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface BigLetterView : NSView . . . @property (getter = isBold) BOOL bold; @property (getter = isItalic) BOOL italic; . . @end </pre></div> </div> 次に実装ファイルに、以下のようなアクセッサを追加。NSFontManagerの説明は、p373を見ればだいたい判る。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@synthesize bold = _bold; - (void) setBold:(BOOL)inBold { NSFont* theFont = self.attributes[NSFontAttributeName]; NSFontManager* theFontManager = [NSFontManager sharedFontManager]; if( inBold ) { theFont = [theFontManager convertFont:theFont toHaveTrait:NSBoldFontMask]; } else { theFont = [theFontManager convertFont:theFont toNotHaveTrait:NSBoldFontMask]; } self.attributes[NSFontAttributeName] = theFont; [self setNeedsDisplay:YES]; } - (BOOL) isBold { NSFontManager* theFontManager = [NSFontManager sharedFontManager]; if( [theFontManager traitsOfFont:self.attributes[NSFontAttributeName]] & NSBoldFontMask ) { return YES; } else { return NO; } } </pre></div> </div> italicのアクセッサの説明とコードは省略。 最後のUIの処理は文章では判りにくいので以下の図を参考にしてください。 NSObjectControllerを追加してcontentsにBigLetterViewを指定する。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/controller.png"></a> チェックボックスBoldとチェックボックスitalicをObjectController経由でBigLetterViewのboldとitalicにbindingする。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/binding1.png"></a> これで、チェックボックスに連動してbigLetterViewの表示が変わるようになります。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/TypingTutor_2.zip" download="">Typing_2.zip</a> に置いておきます。 </article> <article> <h1>ヒレガス本 19章課題</h1> Thu, 26 Dec 2013 00:00:00 +0900 <h1>ヒレガス本 19章課題</h1> 19章には課題は無い。無いので、自分で作る事にする。 作成した、アプリケーションTypingTutorに以下の２つの機能を追加する。 <ol class="arabic simple"> <li>BigLetterViewの矩形に入ったら、カーソルをIビームの形にする。</li> <li>BigLetterViewの矩形に入ったら、バックグラウンド色を変更する。</li> </ol> 最初の課題は簡単です。NSViewにはカーソルを変更する時にオーバーライドするメソッドが用意されている。以下のメソッドを追加すれば良い。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) resetCursorRects { [self addCursorRect:[self bounds] cursor:[NSCursor IBeamCursor]]; } </pre></div> </div> 二番目の課題もp339からのロールオーバーのコードをそのまま入れるだけ。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/TypingTutorWithMouse.zip" download="">TypingTutorWithMouse.zip</a> に置いておきます。 </article> <article> <h1>ターミナルでちょっとした文字列の暗号化と複号化</h1> Mon, 23 Dec 2013 00:00:00 +0900 <h1>ターミナルでちょっとした文字列の暗号化と複号化</h1> MacOSXでは暗号化と複号化の定番はopnesslコマンドです。 ターミナルで以下のようにする事で文字列の暗号化が出来る。暗号化する為のパスワードを聞いてくるので、適当に打ち込む事。 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ echo '暗号化したい文字列' | openssl enc -e -aes128 | base64 </pre></div> </div> base64が必要な理由は、opnesslの出力がバイナリだから。base64を使うと暗号化後のデータが文字列になるので扱いやすい。 使い方は簡単。例えば、文字列「秘密にした大切な事」を暗号化するには、 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ echo '秘密にしたい大切な事' | openssl enc -e -aes128 | base64 enter aes-128-cbc encryption password: (パスワードを入力) Verifying - enter aes-128-cbc encryption password: (もう一度パスワードを入力) U2FsdGVkX18W0ERyPHnFu1rLkHnaytOC61ZDX2j+SIsYEXp4tuD5QTg0M5VvBVQS </pre></div> </div> と行えば良い。最後に出て来た”U2FsdGVk…….”が暗号化後の文字列。 複号化するには、ターミナルで以下のように打ち込めば良い。複号化の為のパスワードを聞いてくるので打ち込む事。 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ echo '暗号化した文字列' | base64 -D | openssl enc -d -aes128 </pre></div> </div> 先ほどの暗号化した文字列を複号化するには、以下のようにする。 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ echo 'U2FsdGVkX18W0ERyPHnFu1rLkHnaytOC61ZDX2j+SIsYEXp4tuD5QTg0M5VvBVQS' | base64 -D | openssl enc -d -aes128 enter aes-128-cbc decryption password: (パスワードを入力) 秘密にしたい大切な事 </pre></div> </div> もちろん、暗号化した時に入力したパスワードを忘れたら元に戻せないので気をつける事。 </article> <article> <h1>mavericksにアップデートしたらgit-completionが行方不明になった</h1> Tue, 29 Oct 2013 00:00:00 +0900 <h1>mavericksにアップデートしたらgit-completionが行方不明になった</h1> mavericksにアップデートしたら、ターミナルを立ち上げるたびに <div class="highlight-sh notranslate"><div class="highlight"><pre>-bash: /usr/share/git-core/git-completion.bash: No such file or directory </pre></div> </div> とエラーを吐かれる。 git-completion.bashの位置が変わったようだ。findで調べると、 <div class="highlight-sh notranslate"><div class="highlight"><pre>/Applications/Xcode.app/Contents/Developer/usr/share/git-core/git-completion.bash </pre></div> </div> と <div class="highlight-sh notranslate"><div class="highlight"><pre>/Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash </pre></div> </div> の２カ所に見つかった。 .bash_profilの <div class="highlight-sh notranslate"><div class="highlight"><pre># git setting source /usr/share/git-core/git-completion.bash </pre></div> </div> を <div class="highlight-sh notranslate"><div class="highlight"><pre># git setting source /Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash </pre></div> </div> と書き換える。 エラーも止まり、補完も効くようになり解決。 </article> <article> <h1>関東62回Cocoa勉強会の資料(10/19)</h1> Fri, 18 Oct 2013 00:00:00 +0900 <h1>関東62回Cocoa勉強会の資料(10/19)</h1> 19日に行うCocoa勉強会の資料です。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/multiWindow.pdf" download="">multiWindow.pdf.</a> <a class="reference download internal" href="https://www.mindto01s.com/_downloads/SampleCodes.zip" download="">SampleCodes.zip.</a> 内容は、Cocoaでマルチウインドウアプリケーションを作る時のコツみたいな事や考え方をダラダラ説明。 </article> <article> <h1>トーマス的な何か</h1> Thu, 10 Oct 2013 00:00:00 +0900 <h1>トーマス的な何か</h1> <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/IMG_0876.png"></a> </div></blockquote> 薄暗い中に、突然コレを見て久しぶりに動揺した。 </article> <article> <h1>ヒレガス本 18章課題続き</h1> Wed, 09 Oct 2013 00:00:00 +0900 <h1>ヒレガス本 18章課題続き</h1> bindigのやり方が間違っている気がして、色々とやってみた。 カスタムViewをbinding対応にするやり方は、Appleのサンプルコードや詳解Objective-C2.0第三版で説明されていますが、個人的にはこれは何か違う気がしたのでパス。 まず、先日の「NSControllerが仲介して逆方向への伝播の設定を行っている」は私の間違い。NSControllerは逆方向への伝播は行っていない。 次に、[NSObject infoForBinding:]を使ってやってみた。コードは、以下のような感じでovalが変更される部分で逆方向にKVCしてるだけ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) setOval:(NSRect)inOval { if( !NSEqualRects(_oval, inOval) ) { _oval = inOval; // binding元への伝播 NSDictionary* theInfo = [self infoForBinding:@"oval"]; if( theInfo ) { NSString* thePath = [theInfo valueForKey:NSObservedKeyPathKey]; NSString* theObject = [theInfo valueForKey:NSObservedObjectKey]; [theObject setValue:[NSValue valueWithRect:_oval] forKeyPath:thePath]; } [self setNeedsDisplay:YES]; } } </pre></div> </div> ２重にbindingするよりも、「正しい」感じがする。 次に、先日も取り上げた <a class="reference external" href="http://tomdalling.com/blog/cocoa/implementing-your-own-cocoa-bindings/">Implementing Your Own Cocoa Bindings</a> を参考にしてコードを書くと、 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) setOval:(NSRect)inOval { if( !NSEqualRects(_oval, inOval) ) { _oval = inOval; // binding元への伝播 [self propagateValue:[NSValue valueWithRect:_oval] forBinding:@"oval"]; [self setNeedsDisplay:YES]; } } </pre></div> </div> ここまで、キレイに書ける。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/OvalDoc_2.zip" download="">OvalDoc_2.zip</a> と <a class="reference download internal" href="https://www.mindto01s.com/_downloads/OvalDoc_3.zip" download="">OvalDoc_3.zip</a> に置いておきます。 </article> <article> <h1>ヒレガス本 18章課題</h1> Sat, 05 Oct 2013 00:00:00 +0900 <h1>ヒレガス本 18章課題</h1> 18章で作成したアプリケーションを元に以下の３つの機能を入れるとの事。 <ul class="simple"> <li>ドキュメントベースにする</li> <li>ファイルの保存と再生に対応する</li> <li>Undo/Redoに対応する</li> </ul> 上記３つは簡単だった。ハマったのは、viewとdocumentのデータを同期するのにbindingを使った所。 IBを使って操作していると、bind:toObject:withKeyPath:options:１行呼出すだけで双方向にデータを同期してくれると勘違いしていた。 双方向にデータをやり取りするには、それぞれにbind:toObject:withKeyPath:options:を呼出す必要があった。 IB上ではおそらくNSControllerが仲介して逆方向への伝播の設定を行っているのだと思われる。 コード上で行うには、今後は <a class="reference external" href="http://tomdalling.com/blog/cocoa/implementing-your-own-cocoa-bindings/">Implementing Your Own Cocoa Bindings</a> を参考にして <div class="highlight-objc notranslate"><div class="highlight"><pre>[NSObject propagateValue:(id)value forBinding:(NSString*)binding]; </pre></div> </div> を使うとよいかもです。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/OvalDoc.zip" download="">OvalDoc.zip</a> に置いておきます。 </article> <article> <h1>ヒレガス本 17章課題</h1> Fri, 04 Oct 2013 00:00:00 +0900 <h1>ヒレガス本 17章課題</h1> ランダムな直線の描画部分を曲線に変えろとの事。 これは簡単。変更部分は１カ所だけ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>thePoint = [self randomPoint]; [path lineToPoint:thePoint]; </pre></div> </div> を <div class="highlight-objc notranslate"><div class="highlight"><pre>[path curveToPoint:[self randomPoint] controlPoint1:[self randomPoint] controlPoint2:[self randomPoint]]; </pre></div> </div> に変えただけ。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/DrawingFun.zip" download="">DrawingFun.zip</a> に置いておきます。 <div class="section" id="id2"> <h2>注意点</h2> P302の図が説明文とAutosizingの設定が違っている。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/image1.png"></a> </div></blockquote> 上記の設定だとNSScrollViewがリサイズされると、StrectViewも同じようにリサイズされてしまう。 P301の説明のように左下隅に固定してリサイズされないようにするには以下のように設定する。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/image2.png"></a> </div></blockquote> 違いはAutosizingの中の十字の部分だけ。 </div> </article> <article> <h1>ヒレガス本 16章課題その２</h1> Tue, 01 Oct 2013 00:00:00 +0900 <h1>ヒレガス本 16章課題その２</h1> 前回のアップデートスクリプトに加えて、ビルド時のチェックツールも作ってみた。 機能は、 <ul class="simple"> <li>既に存在しないキーで指定された、翻訳文が有れば警告</li> <li>ソースコード中にキーが有るが、*.stringsに存在しないキーがあれば警告</li> <li>マージがコンクリフトしている場所をエラー</li> </ul> とするツールを作った。 <div class="highlight-bash notranslate"><div class="highlight"><pre>#!/bin/sh # # *.lproj/Localizable.stringsの内容のチェックを行う # stringsの拡張子 theStringsExt=".strings" # ローカライズディレクトリの拡張子 theLocalizeExt=".lproj" # Localizable.stringのファイル名 theLocalizableStrings="Localizable"$theStringsExt ########################################################################################## # # missingなキーワードの警告 # ########################################################################################## # warningMessage フルパス行番号警告メッセージ警告行のテキスト function warningMissingKeyWordMessage() { local FULL_PATH_FILE_NAME=$1 local KEYWORD_STRING=$2 echo $FULL_PATH_FILE_NAME"::: warning:" $KEYWORD_STRING is a missing key word.":" $KEYWORD_STRING } ########################################################################################## # # danglingなキーワードの警告 # ########################################################################################## function warningDanglingKeyWordMessage() { local FULL_PATH_FILE_NAME=$1 local KEYWORD_STRING=$2 echo $FULL_PATH_FILE_NAME":"`grep -n $KEYWORD_STRING $FULL_PATH_FILE_NAME | cut -d":" -f1`":0: warning:" $KEYWORD_STRING is a dangling key word.":" `grep $KEYWORD_STRING $FULL_PATH_FILE_NAME` } ########################################################################################## # # エラーメッセージを出力 # ########################################################################################## # errorMessage フルパス行番号エラーメッセージエラー行のテキスト function errorConflictMessage() { local FULL_PATH_FILE_NAME=$1 local LINE_NUMBER=$2 local TEXT_STRING=$3 echo $FULL_PATH_FILE_NAME":"$LINE_NUMBER":0: error: Merge conflict :" $TEXT_STRING } # Base.lprojのフルパス theBaseLocalizableStrings=`pwd`/Base$theLocalizeExt/$theLocalizableStrings # キーだけのリストにしてtmpへ保存する # 一時的な作業フォルダーを作成する theTempDir="tmp" if ! [ -d $theTempDir ]; then mkdir $theTempDir fi # コメントと空白行を削除 cat $theBaseLocalizableStrings | sed -e 's:/\*.*\*/::' | sed -e '/^[<space><tab>]*$/d' | cut -d' ' -f1 > $theTempDir/tmplist.txt # forループの区切りを改行だけにする IFS=$'\n' # Base.lproj/以下以外のLocalizable.stringsを全部ループ for theIterator in `find \`pwd\` -regex ".*/Base.lproj/.*" -prune -o -regex ".*lproj/Localizable\.strings" -print` do # 右側にだけある項目 for theWord in `cat $theIterator | sed -e '/^<<<<<<<.*$/d' | sed -e '/^|||||||.*$/d' | sed -e '/^=======.*$/d' | sed -e '/^>>>>>>>.*$/d' | sed -e 's:/\*.*\*/::' | sed -e '/^[<space><tab>]*$/d' | cut -d' ' -f1 | sort | uniq | comm -13 $theTempDir/tmplist.txt -` do warningDanglingKeyWordMessage $theIterator $theWord done # 左側にだけある項目 for theWord in `cat $theIterator | sed -e 's/^<<<<<<<.*$//' | sed -e 's/^|||||||.*$//' | sed -e 's/^=======.*$//' | sed -e 's/^>>>>>>>.*$//' | sed -e 's:/\*.*\*/::' | sed -e '/^[<space><tab>]*$/d' | cut -d' ' -f1 | sort | uniq | comm -23 $theTempDir/tmplist.txt -` do warningMissingKeyWordMessage $theIterator $theWord done # コンフリクトな行(下の四行など)をコンクリフトだと報告する # <<<<<<< # ||||||| # ======= # >>>>>>> for theConflictLine in `cat $theIterator | grep -n '^<<<<<<<\|^=======\|^>>>>>>>\|^|||||||'` do errorConflictMessage $theIterator `echo $theConflictLine | cut -d':' -f1` `echo $theConflictLine | cut -d':' -f2` done done # 後片付け rm -f $theTempDir/tmplist.txt </pre></div> </div> XCodeに組み込んで使います。 ここに置いて、 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/filePath.png"></a> </div></blockquote> こんな風に設定すると。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/setting.png"></a> </div></blockquote> ビルド時に、こんな風に警告が出たりエラーが出ます。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/error.png"></a> </div></blockquote> 実用的になるかどうかは不明。 16章はここら辺で見切りを付けて明日からは次の章を行うつもり。 </article> <article> <h1>ヒレガス本 16章課題</h1> Wed, 25 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 16章課題</h1> 16章のローカライズの章には課題は無い。無いので自分で課題を作ってみた。 genstringsを使った文字列のローカライズを支援するツールを作成する。 genstringsが自動でLocalizable.stringを作れるのはよい。楽だ。開発の最後の段階でローカライズを行い、１回の翻訳で全ての文字列を翻訳できるのならば、問題も無い。 しかし、実際には開発を行いながらローカライズも随時行うのが私のやり方です。面倒だと思ってもユーザーインターフェイスを追加したり削除したりします。ソースコードもリファクタリングしてアラートの数を減らしたりします。 genstringsはLocalizable.stringを上書きしてしまうので、そのまま使うと翻訳済みのデータが消えてします。 そこで、genstringsとdiff3を組み合わせて、翻訳済みのデータを上書きしないようにシェルスクリプトを書いてみました。練習でつくってみただけですので、実開発では使っていません。 <div class="highlight-bash notranslate"><div class="highlight"><pre>#!/bin/sh # # updateLocalizableStrings # # マージツール # stringsの拡張子 theStringsExt=".strings" # ローカライズディレクトリの拡張子 theLocalizeExt=".lproj" # Localizable.stringのファイル名 theLocalizableStrings="Localizable"$theStringsExt theTempDir="tmp" theNewBaseLocalizableStrings=$theTempDir/$theLocalizableStrings ########################################################################################## # # 新たに生成されたLocalizable.stringsを"tmp/Localizable8.strings"に用意する # ########################################################################################## # 一時的な作業フォルダーを作成する if ! [ -d $theTempDir ]; then mkdir $theTempDir fi # ソースコードをなめて、置換えテーブルを作成。作成場所は"./tmp/Localizable.strings" genstrings -o $theTempDir `find . -name '*.[hcm]'` # UTF-8に変換 iconv -f UTF-16 -t UTF-8 < $theNewBaseLocalizableStrings > $theNewBaseLocalizableStrings"_tmp" # 後片付け mv $theNewBaseLocalizableStrings"_tmp" $theNewBaseLocalizableStrings ########################################################################################## # # 古いLocalizable.stringsは"Base.lproj/Localizable.strings"にあると仮定する。なかったら作る # ########################################################################################## theOldBaseLocalizableStrings="Base"$theLocalizeExt/$theLocalizableStrings if ! [ -f $theOldBaseLocalizableStrings ]; then cp $theNewBaseLocalizableStrings $theOldBaseLocalizableStrings fi ########################################################################################## # # "Base"ディレクトリ以外の"*.lproj/Localizable.strings"をdiff3でアップデートする # ########################################################################################## for theLocaleStringsDir in `find . -name "*.lproj" -print` do if [ $theLocaleStringsDir != "./Base.lproj" ]; then theLocaleStringsFile=$theLocaleStringsDir"/Localizable.strings" # 無ければ作り、あればdiff3でアップデート if ! [ -f $theLocaleStringsFile ]; then cp $theNewBaseLocalizableStrings $theLocaleStringsFile else diff3 -m $theLocaleStringsFile $theOldBaseLocalizableStrings $theNewBaseLocalizableStrings > $theLocaleStringsFile"_tmp" mv $theLocaleStringsFile"_tmp" $theLocaleStringsFile fi fi done # 最後に"Base.lproj/Localizable.strings"を更新する cp $theNewBaseLocalizableStrings $theOldBaseLocalizableStrings </pre></div> </div> 使い方は、 “*.m” や “*.lproj” があるディレクトリで呼出すだけです。必要に応じて “*.lproj/Localizable.strings” のデータが更新されます。コンクリフトが発生した場合は、gitやsvnでおなじみの”<<<<<<<<”の文字列が書き込まれますので随時対処してください。 このスクリプトの課題 <ol class="arabic simple"> <li>diffのように行毎に比較して判断するのではなく、”*.strings”をパースするコードを書けばもう少し知的な振る舞いが出来そう。</li> <li>ibtoolの出力に対してもアップデート出来るコマンドがあると便利かも。</li> <li>プログラマだけで開発するのならよいけど、翻訳担当にコマンドラインインターフェイスはキツいかも。せめてExcelで編集csvで読込みが出来るようにするべきでは？</li> </ol> </article> <article> <h1>ヒレガス本 15章課題</h1> Sat, 21 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 15章課題</h1> 削除しないが昇給なし(Keep, but no raise)ボタンを追加しろとの事。 これも簡単、KVCで行うと、NSArrayに含まれる全てのオブジェクトのプロパティーにアクセス出来る。 Controller経由でArrayを取得する事で、Undo/Redoにも対応してる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) KeepButNoRaise:(id)sender { NSArray* theSelectedPeople = [employeeController selectedObjects]; [theSelectedPeople setValue:[NSNumber numberWithFloat:0.0] forKeyPath:@"expectedRaise"]; } </pre></div> </div> 後は、ボタンのenable/disableはbindingで選択された行数で判定。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/binding.png"></a> </div></blockquote> プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/RaiseMan_AlertPanel.zip" download="">RaiseMan_AlertPanel</a> に置いておきます。 </article> <article> <h1>ヒレガス本 14章課題</h1> Sat, 21 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 14章課題</h1> アプリケーションがアクティブになった時にBeep音をならせとの事。 既にapplication delegateが設定されてあるので、すごい簡単。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)applicationDidBecomeActive:(NSNotification *)notification { NSBeep(); } </pre></div> </div> 課題の問題中の、Notification文字列が違うのはわざとなのだろうか？ プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/RaiseMan_Notification.zip" download="">RaiseMan_Notification</a> に置いておきます。 </article> <article> <h1>ARCって楽だと思ったら、メモリリークしてる</h1> Sat, 21 Sep 2013 00:00:00 +0900 <h1>ARCって楽だと思ったら、メモリリークしてる</h1> deallocが呼ばれないので調べてみると、巡回参照が生じているらしい。IBOutletを指定したらretainしないと思ってたら、間違いだったようだ。 以下のように、__weak指定して、巡回参照を押さえてdeallocを呼ばれるようにした。 <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>@interface RMDocument : NSDocument { NSMutableArray* employees; IBOutlet __weak NSTableView* tableView; IBOutlet __weak NSArrayController* employeeController; } </pre></div> </div> </div></blockquote> ARCの導入でコーディング量は減ったけど、考え方は変わらない。手続き的な表記から宣言的な表記に変わったと理解して@interfaceを書く時にメモリ管理を考えるようにするとよいのかもしれない。 もう一度、@synthesizeとか@propetyの書き方を調べ直さないとダメだな。 </article> <article> <h1>ヒレガス本 13章課題</h1> Fri, 20 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 13章課題</h1> UserDefaultの値を初期値にするボタンを設置せよとの事。 PreferenceController.mに以下のようなコードを追加すれば可能。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) resetPreferences:(id)sender { NSUserDefaults* theDefault = [NSUserDefaults standardUserDefaults]; [theDefault removePersistentDomainForName:[[NSBundle mainBundle] bundleIdentifier]]; [colorWell setColor:[PreferenceController preferenceTableBgColor]]; [checkBox setState:[PreferenceController preferenceEmptyDoc]]; } </pre></div> </div> しかし、バインディングを使って実装し[NSUserDefaultsController revertToInitialValues]を使えばもっと簡単に実装出来る。ググってもそちらの方はあまりでないのはiOSにNSUserDefaultsControllerが無いからなのかもしれない。 プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/RaiseMan_UserDefault.zip" download="">RaiseMan_UserDefault</a> に置いておきます。 <div class="section" id="id2"> <h2>参考文献</h2> <ul class="simple"> <li><a class="reference external" href="https://developer.apple.com/jp/documentation/Cocoa/Conceptual/CocoaBindings/Concepts/NSUserDefaultsController.html">ユーザデフォルトおよびバインディング</a></li> <li><a class="reference external" href="http://xcatsan.blogspot.jp/2008/09/12.html">(旧) Cocoaの日々ツールバー（その12）</a></li> </ul> </div> </article> <article> <h1>デバッグ時に復元機能をOffにする</h1> Fri, 20 Sep 2013 00:00:00 +0900 <h1>デバッグ時に復元機能をOffにする</h1> MacOSX10.7以降では、アプリケーションにドキュメントの復元機能が追加された。このため、初期状態から起動した時のデバッグが困難になった。 色々と面倒だなと思っていたら、XCodeにその復元機能をOffにするOptionが追加されていた。 スキーム編集ダイアログで、”Run XXX.app” -> “Options” -> “Persistant state”をON/OFFするだけで切り替えられる。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/PersistantState.png"></a> </div></blockquote> 便利だ。 <div class="section" id="id1"> <h2>参考文献</h2> <ul class="simple"> <li>MacOSX Cocoa プログラミング P259</li> </ul> </div> </article> <article> <h1>objective-cの文字列キーの定義</h1> Fri, 20 Sep 2013 00:00:00 +0900 <h1>objective-cの文字列キーの定義</h1> ヒレガス本第四版の第13章を読んでの感想。一昔前は、プリプロセッサマクロの#defineを使用していた。最近はグローバル変数を使うのが定石らしい。 XXXXXX_KEYを定義したい場合には、 <blockquote> <div>*.hに <div class="highlight-objc notranslate"><div class="highlight"><pre>extern NSString* const XXXXXX_KEY </pre></div> </div> *.mに <div class="highlight-objc notranslate"><div class="highlight"><pre>extern NSString* const XXXXXX_KEY = @"XXXXXX_KEY"; </pre></div> </div> </div></blockquote> と書くのがお作法のようです。 自分は#defineのやり方とコチラのやり方を行ったり来たりしていたが、今後はグローバル変数のやり方に統一するつもり。 </article> <article> <h1>ヒレガス本 12章課題</h1> Fri, 20 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 12章課題</h1> 課題は、NSBundleを利用してnibをロードし独自のAboutPanelを表示しろとの事。 早速NSBundleを使ってNibをロードしようと、 <div class="highlight-objc notranslate"><div class="highlight"><pre>[NSBundle loadNibNamed: owner:] </pre></div> </div> を使おうとしたらDeprecatedとの事。 仕方が無いので、NSNibを使用して以下のように書いた。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) showAbouPanel:(id)sender { if( !aboutPane ) { NSNib* theAboutPanelNib; theAboutPanelNib = [[NSNib alloc] initWithNibNamed:@"aboutPanel.nib" bundle:nil]; NSArray* theTopLevelObject; if( [theAboutPanelNib instantiateWithOwner:self topLevelObjects:&theTopLevelObject] ) { NSLog(@"aboutPanel loaded from nib. %@", theTopLevelObject); } } [aboutPane makeKeyAndOrderFront:sender]; } </pre></div> </div> プロジェクトファイルは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/RaiseMan_NibAndWindowController.zip" download="">RaiseMan_NibAndWindowController</a> に置いておきます。 </article> <article> <h1>ヒレガス本 11章課題</h1> Thu, 19 Sep 2013 00:00:00 +0900 <h1>ヒレガス本 11章課題</h1> 課題を行ってみてミスを２つした。 <ul class="simple"> <li>TableViewに何も表示されない</li> </ul> 理由は、NSArrayControllerのManaged Object Contextを設定をし忘れていた。 Managed Object ContextをFile’s OwnerのManagedObjectContextにbindingしする必要があったのに設定を忘れていた。 <ul class="simple"> <li>Make/ModelとPriceの編集が出来なかった</li> </ul> 理由は、それぞれのTextViewで、Binding PropatyのConditionally Sets EditableをONにしていなかった事が原因だった。 課題その物の、新しいレコードを追加してすぐに編集を開始するには以下のコードを追加した。 <div class="highlight-objc notranslate"><div class="highlight"><pre>// // CarArrayController.h // CarLot #import <Cocoa/Cocoa.h> @interface CarArrayController : NSArrayController { IBOutlet NSTableView* tableView; } @end </pre></div> </div> <div class="highlight-objc notranslate"><div class="highlight"><pre>// // CarArrayController.m // CarLot #import "CarArrayController.h" @implementation CarArrayController // managedObjectContextに変化があれば managedObjectContextObjectsDidChange:を呼び出し // tableを編集状態にする - (void) awakeFromNib { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(managedObjectContextObjectsDidChange:) name:NSManagedObjectContextObjectsDidChangeNotification object:[self managedObjectContext]]; } // 終了時にobservingを停止する - (void) dealloc { [[NSNotificationCenter defaultCenter] removeObserver:self]; } - (void) managedObjectContextObjectsDidChange:(NSNotification*)inNotification { NSManagedObject* theObject = [[[inNotification userInfo] valueForKey:NSInsertedObjectsKey] anyObject]; if( theObject ) { NSUInteger theRow = [[self arrangedObjects] indexOfObject:theObject]; [tableView editColumn:0 row:theRow withEvent:nil select:YES]; } } // これはヒレガス本そのまま - (id) newObject { id theNewObject = [ super newObject]; NSDate* theNow = [NSDate date]; [theNewObject setValue:theNow forKey:@"datePurchased"]; return theNewObject; } @end </pre></div> </div> しかし、Undo/Redoがうまく働いていないように見える。Undo/Redoで内部データとTableViewのレコードがうまく連動していない。 CoreDataだとUndo/Redoを自動で行うので手を入れなくて良いと思っていたが違うようだ。 前々回の、Cocoa勉強会でCoreDataのUndoManagerについて平井さんが発表していた気がしたのでハンドセットを読み返した。しかし、デバッグのやり方しか書いていない。 CoreDataの基礎の章なので深くは追求しない事にした。 </article> <article> <h1>NSArchiverはdeprecated</h1> Wed, 18 Sep 2013 00:00:00 +0900 <h1>NSArchiverはdeprecated</h1> ヒレガス本でアーカイブ化の章を読んで、NSArchiverの事が一言も出ていなかった。不思議に思い、ググると <a class="reference external" href="http://deathcube.blog36.fc2.com/blog-entry-17.html">Cocoaでのアーカイブとシリアライズ機能アーカイブ編</a> が見つかる。 10.3以降はNSArchiverはdeprecatedなのでNSKeyedArchiverを使うべきとの事。 要点は、 <ul class="simple"> <li>新規プリケーションにはNSKeyedArchiverを使え。NSArchiverは後方互換性の為だけに残されている。</li> <li>setVersionも不要。NSKeyedArchiverを使えば必要ない。</li> </ul> との事。歳はとりたくないなぁ。 </article> <article> <h1>ヒレガス本第四版第９章 NSUndoManagerの覚え書き</h1> Tue, 17 Sep 2013 00:00:00 +0900 <h1>ヒレガス本第四版第９章 NSUndoManagerの覚え書き</h1> <div class="section" id="nsinvocation"> <h2>NSInvocationについて</h2> たった半ページでNSInvocationを説明をしている。予備知識が無いと理解出来ない。 NSInvocationを理解するには「詳細Objective-C 2.0第３版」 p385を参照する事。 </div> <div class="section" id="nsundomanager-preparewithinvocationtarget-self"> <h2>[NSUndoManager prepareWithInvocationTarget:self]について</h2> [NSUndoManager prepareWithInvocationTarget:self]の返り値はid型です。 この返り値がid型である為に、どのようなメッセージを投げられてもコンパイル時にはエラーにはなりません。 そのため、ヒレガス本の例にあるように簡潔にコードが書けます。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) insertObject:(Person*)inPerson inEmployeesAtIndex:(NSUInteger)inIndex { NSUndoManager* theUndoMgr = [self undoManager]; // この行はid型に対してメッセージを送っている [[theUndoMgr prepareWithInvocationTarget:self] removeObjectFromEmployeesAtIndex:inIndex]; if( ![theUndoMgr isUndoing] ) { [theUndoMgr setActionName:@"Add Person"]; } [employees insertObject:inPerson atIndex:inIndex]; } </pre></div> </div> より防衛的に書く場合は、型チェックをすり抜ける上記のような書き方はよくない。以下のように型を指定した書き方をした方がよい。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void) insertObject:(Person*)inPerson inEmployeesAtIndex:(NSUInteger)inIndex { NSUndoManager* theUndoMgr = [self undoManager]; RMDocument* theInstance = [theUndoMgr prepareWithInvocationTarget:self]; // RMDocumentの型にする事で凡ミスが減る [theInstance removeObjectFromEmployeesAtIndex:inIndex]; if( ![theUndoMgr isUndoing] ) { [theUndoMgr setActionName:@"Add Person"]; } [employees insertObject:inPerson atIndex:inIndex]; } </pre></div> </div> </div> </article> <article> <h1>CodeSignが”check your system clock”とエラーを吐いたら時間を再設定する</h1> Fri, 30 Aug 2013 00:00:00 +0900 <h1>CodeSignが”check your system clock”とエラーを吐いたら時間を再設定する</h1> xcodebuildをVMWareで作った仮想環境で実行したらcodeSignがまたエラーを吐いてうまく行かない。 エラーメッセージを見ると、時刻が合ってないとの事。 仕方が無いので、GUI経由でログインしてシステム環境設定>日付と時刻を開いた。自動で再設定されたよ。 次はうまくビルドされたが、GUIでログインしなければならないのはメンドクサイ。 VMWareを立ち上げっぱなしにしてれば良いのだろうか？ </article> <article> <h1>CodeSignが”User interaction is not allowed.”とエラーを吐いたら”security unlock-keychain”を実行する</h1> Wed, 28 Aug 2013 00:00:00 +0900 <h1>CodeSignが”User interaction is not allowed.”とエラーを吐いたら”security unlock-keychain”を実行する</h1> xcodebuildをVMWareで作った仮想環境で実行したらcodeSignがエラーを吐いてうまく行かない。 ググると、keychainをアンロックする必要があるとの事だった。 GUI経由で行うと問題が無かったのはkeyChainのダイアログが出て来たのでそこで解決が出来ていたのだろう。 ssh経由でkeyChainのアンロックは <div class="highlight-sh notranslate"><div class="highlight"><pre>security unlock-keychain </pre></div> </div> を行えば良い。 </article> <article> <h1>git-ignoreの設定</h1> Wed, 28 Aug 2013 00:00:00 +0900 <h1>git-ignoreの設定</h1> ディレクトリを掘るたびに、色々と設定していたが、サブディレクトリのファイルを一括で無視する方法がはじめか有った。 「＊＊／」で、サブディレクトリにたいして再帰的に適応してくれるそうです。 <div class="highlight-sh notranslate"><div class="highlight"><pre># .gitignore **/build/ **/.DS_Store **/*.xcodeproj/* !**/*.xcodeproj/project.pbxproj </pre></div> </div> ディレクトリを掘るのが楽になる。 <div class="section" id="id1"> <h2>参考文献</h2> <ul class="simple"> <li><a class="reference external" href="http://http://git-scm.com/book/ja/Git-の基本-変更内容のリポジトリへの記録#ファイルの無視">Git-の基本-変更内容のリポジトリへの記録-ファイルの無視</a></li> </ul> </div> </article> <article> <h1>shellでMacOSXのバージョンを調べる</h1> Fri, 23 Aug 2013 00:00:00 +0900 <h1>shellでMacOSXのバージョンを調べる</h1> sw_versを使う。unameよりも便利。 バージョン番号の取得 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ sw_vers -productVersion 10.8.4 </pre></div> </div> ビルド番号の取得 <div class="highlight-sh notranslate"><div class="highlight"><pre>$ sw_vers -buildVersion 12E55 </pre></div> </div> さらにバージョン番号を分解して扱いやすくするには、以下のようにcutを使えば良い。 <ul class="simple"> <li>メジャー</li> </ul> <blockquote> <div><div class="highlight-sh notranslate"><div class="highlight"><pre>$ sw_vers -productVersion | cut -f1 -d "." 10 </pre></div> </div> </div></blockquote> <ul class="simple"> <li>マイナー</li> </ul> <blockquote> <div><div class="highlight-sh notranslate"><div class="highlight"><pre>$ sw_vers -productVersion | cut -f2 -d "." 8 </pre></div> </div> </div></blockquote> <ul class="simple"> <li>リビジョン</li> </ul> <blockquote> <div><div class="highlight-sh notranslate"><div class="highlight"><pre>$ sw_vers -productVersion | cut -f3 -d "." 4 </pre></div> </div> </div></blockquote> 実際に使うのはマイナー番号だろうな。 </article> <article> <h1>xcode-select</h1> Thu, 22 Aug 2013 00:00:00 +0900 <h1>xcode-select</h1> ２つのバージョンのxcodeをインストールしてハマった。 makeファイルからxcodebuildを呼出しているのだが古いxcodeの設定で実行されていてコマンドラインからうまくコンパイル出来なかった。 xcodebuildのオプションを使うのかもしれないと、少ししらべるとxcode-selectなるコマンドを発見。 <div class="highlight-sh notranslate"><div class="highlight"><pre>xcode-select: Report or change the path to the active Xcode installation for this machine. Usage: xcode-select --print-path Prints the path of the active Xcode folder or: xcode-select --switch <xcode_path> Sets the path for the active Xcode folder or: xcode-select --version Prints the version of xcode-select </pre></div> </div> DP版のxcodeを使うには <div class="highlight-sh notranslate"><div class="highlight"><pre>xcode-select --switch /Applications/Xcode5-DP4.app/Contents/Developer </pre></div> </div> を入れれば使える。元に戻すには、 <div class="highlight-sh notranslate"><div class="highlight"><pre>xcode-select --switch /Applications/Xcode.app/Contents/Developer </pre></div> </div> を入れれば良い。 </article> <article> <h1>Cocoaの添字演算子”[]”のオーバーロード</h1> Sun, 04 Aug 2013 00:00:00 +0900 <h1>Cocoaの添字演算子”[]”のオーバーロード</h1> <ul class="simple"> <li>数値による添字演算子のオーバーロード</li> </ul> 以下のメソッドを実装しているとObj[nnn]が使えるようになる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (id)objectAtIndexedSubscript:(NSUInteger)idx; - (void)setObject:(id)obj atIndexedSubscript:(NSUInteger)idx; </pre></div> </div> <ul class="simple"> <li>文字列による添字演算子のオーバーロド</li> </ul> 以下のメソッドを実装しているとobj[@”string”]が使えるようになる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (id)objectAtKeyedSubscript:(id <NSCopying>)key; - (void)setObject:(id)obj forKeyedSubscript:(id <NSCopying>)key; </pre></div> </div> NSArrayとNSDictonary以外でどのように使うべきかは不明。C++のように超絶技巧で使うときも有るのかもしれない。 </article> <article> <h1>KVCでObjectからまとめて値の参照と設定が出来るメソッド</h1> Wed, 31 Jul 2013 00:00:00 +0900 <h1>KVCでObjectからまとめて値の参照と設定が出来るメソッド</h1> KVCでObjectからまとめて値の参照と設定が出来るメソッドが何処かの本に書いてあった記憶が有ったので、本棚をひっくり返す。 翔泳社の”入門 Objective-C 2.0” p290からキーバリューコーディングのバッチ処理として説明が有った。 <ul class="simple"> <li>ObjectへNSDictonaryにあるキーと名前が一致するプロパティに値を入れるメソッド</li> </ul> <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)setValuesForKeysWithDictionary:(NSDictionary *)keyedValues; </pre></div> </div> <ul class="simple"> <li>ObjectからNSArrayにあるキーに一致する名前のプロパティーの値でNSDictonaryを作るメソッド</li> </ul> <div class="highlight-objc notranslate"><div class="highlight"><pre>- (NSDictionary *)dictionaryWithValuesForKeys:(NSArray *)keys; </pre></div> </div> リフトアンドスタンンプツール等の作成に使えるとの事でした。多分インスペクタパネルのような物にも使えると思う。 <div class="section" id="id1"> <h2>参考文献</h2> 翔泳社の”入門 Objective-C 2.0” p290 </div> </article> <article> <h1>運転免許の書き換えに行く</h1> Tue, 30 Jul 2013 00:00:00 +0900 <h1>運転免許の書き換えに行く</h1> 平日に行ったらすごい空いてた。五年後も平日に行こう。 </article> <article> <h1>ペーパードライバー教習に行った</h1> Mon, 29 Jul 2013 00:00:00 +0900 <h1>ペーパードライバー教習に行った</h1> 10年近くハンドルを握っていなかったのだが、以外と運転出来て驚いた。 しかし、最初に教習用のコースを運転出来て良かった。ブレーキとアクセルの位置を忘れていた。 いきなり、自分で運転していたら暴走させていたかも。:-) </article> <article> <h1>キューとタイマーをくっつけたクラス</h1> Thu, 23 May 2013 00:00:00 +0900 <h1>キューとタイマーをくっつけたクラス</h1> よくある疑似イベントループもどきのクラスを書いた。 テスト用に書いたので実用になるかどうかは不明。 使い方は、こんな感じ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>{ . . . timerQueue = [[MTLTimerQueue timerQueueWithTarget:self action:@selector(logObject:) firstInterval:1.0 continueInterval:0.1] retain]; [timerQueue enqueue:@"+1"]; [timerQueue enqueue:@"+2"]; [timerQueue enqueue:@"+3"]; [timerQueue enqueue:@"+4"]; [timerQueue enqueue:@"+5"]; . . . } - (IBAction) logObject:(id)sender { NSLog(@"theObject => %@", sender); } </pre></div> </div> この場合は、キューに、値を積んで1.0秒後に、0.1秒毎に積んだ値を取り出して出力する。 firstIntervalとcontinueIntervalで時間を調整する。 continueIntervalがマイナスの値の場合は、イベントループを回さないで一気に取り出す。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/MTLTimerQueue.zip" download="">MTLTimerQueue.zip.</a> </article> <article> <h1>Cocoa勉強会資料(5/18用)追加</h1> Sat, 18 May 2013 00:00:00 +0900 <h1>Cocoa勉強会資料(5/18用)追加</h1> 18日に行うCocoa勉強会の資料の追加です。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/aNoKeyboard.zip" download="">aNoKeyboard.zip.</a> 内容は、kextまわりの作り方みたいな。 </article> <article> <h1>Cocoa勉強会資料(5/18用)</h1> Thu, 16 May 2013 00:00:00 +0900 <h1>Cocoa勉強会資料(5/18用)</h1> 18日に行うCocoa勉強会の資料です。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/CocoaOfCoC.zip" download="">CocoaOfCoC.zip.</a> 内容は、Cocoaで設定より規約をやってみたみたいな。 </article> <article> <h1>OSBundleLibraries</h1> Sat, 20 Apr 2013 00:00:00 +0900 <h1>OSBundleLibraries</h1> kextを作る時、info.plsitに手作業で依存するライブラリを記述する必要がある。 OSBundleLibrariesにライブラリの識別子と互換性がある最低バージョン版番号を記述する。 例えばこんな感じ。 <div class="highlight-xml notranslate"><div class="highlight"><pre><key>OSBundleLibraries</key> <dict> <key>com.apple.kpi.iokit</key> <string>12.3</string> </dict> </pre></div> </div> この時、どのライブラリのどのバージョンに依存しているかは、”kextlibs”コマンドで確認する事が出来る。 例えばこんな感じ。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ kextlibs PATH/FILE.kext For all architectures: com.apple.kpi.iokit = 12.3 </pre></div> </div> いちいち手作業でライブラリの依存関係を調べるのは面倒くさいので、一度ビルドした後に”kextlibs”コマンドで、依存関係を出力させて、plsitに転記するのが楽。 また、”kextload”時に <div class="highlight-bash notranslate"><div class="highlight"><pre>/PATH/FILE.kext - no compatible dependency found for com.apple.kpi.iokit. </pre></div> </div> とか <div class="highlight-bash notranslate"><div class="highlight"><pre>Check library declarations for your kext with kextlibs(8). </pre></div> </div> 等のエラーが出た場合も、悩まずに”kextlibs”ですぐにライブラリのidとバージョンを出力させて、info.plsitを確認すると良い。 </article> <article> <h1>２ボタンキーボード</h1> Mon, 15 Apr 2013 00:00:00 +0900 <h1>２ボタンキーボード</h1> <a class="reference external" href="http://weekly.ascii.jp/elem/000/000/137/137891/">週間アスキー</a> で紹介されていた、<a class="reference external" href="http://www.omiya-giken.com/?page_id=431">英数/かなキーボード for Macintosh</a> をパクってArduinoで作ってみた。 <div class="section" id="id3"> <h2>ハードウェア</h2> ハードウェアは２つのボタンを”Arduino Leonardo”のPin13とPin12につないだだけ。 プルアップ抵抗もソフトウェアでONにするので、ハードウェア側には無し。 作図がメンドクサイので図は無し。 </div> <div class="section" id="id4"> <h2>ソフトウェア</h2> Arduino IDEに付属のKeyboardライブラリだと「英数/かな」キーコードが送れない仕様だった。 <a class="reference external" href="http://blog.livedoor.jp/hardyboy/archives/5983665.html">生のキーコードが送れるソースコード</a> が公開されていたので、そのコードを利用して以下のようなコードを書いた。 <div class="highlight-c++ notranslate"><div class="highlight"><pre>#include "USBrawkeyboard.h" USBrawkeyboard rawkybd; #define RIGHT_KEY_CODE 0x90 #define LEFT_KEY_CODE 0x91 const int kRightSwitch = 12; const int kLeftSwitch = 13; int gPreviousRightSwitchState = 0; int gPreviousLeftSwitchState = 0; void setup() { pinMode(kRightSwitch, INPUT_PULLUP); pinMode(kLeftSwitch, INPUT_PULLUP); delay(1000); gPreviousRightSwitchState = digitalRead(kRightSwitch); gPreviousLeftSwitchState = digitalRead(kLeftSwitch); Keyboard.begin(); rawkybd.begin() ; delay(1000); } void loop() { int theRightSwitchState = digitalRead(kRightSwitch); int theLeftSwitchState = digitalRead(kLeftSwitch); if( theRightSwitchState != gPreviousRightSwitchState ) { if( theRightSwitchState == LOW ) { rawkybd.press(RIGHT_KEY_CODE); } else { rawkybd.release(RIGHT_KEY_CODE); } gPreviousRightSwitchState = theRightSwitchState; } if( theLeftSwitchState != gPreviousLeftSwitchState ) { if( theLeftSwitchState == LOW ) { rawkybd.press(LEFT_KEY_CODE); } else { rawkybd.release(LEFT_KEY_CODE); } gPreviousLeftSwitchState = theLeftSwitchState; } delay(100); } </pre></div> </div> コチラからダウンロード出来ます。 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/sketch_apr14a.zip" download="">sketch_apr14a.zip</a> 今のところ入力モードの切り替えしか出来ないのでホンノリ便利に使えるMacOSX側のユーティリティーが出来ないか妄想中。 </div> <div class="section" id="id6"> <h2>参考文献</h2> <ul class="simple"> <li><a class="reference external" href="http://blog.livedoor.jp/hardyboy/archives/5983665.html">PS/2キーボード変換器の製作(17) USBキーボードの任意コードの送出</a></li> </ul> <blockquote> <div>Arduino IDEに付属のKeyboardライブラリだと生のUSBキーコードが送れない仕様だったので、このサイトにあるソースコードを流用させていただきました。</div></blockquote> <ul class="simple"> <li><a class="reference external" href="http://www2d.biglobe.ne.jp/%7Emsyk/keyboard/layout/usbkeycode.html">USBキーボードのキーコード</a></li> </ul> <blockquote> <div>ここ以外に「英数/かな」のキーコードが説明されているサイトは見つけられなかった。</div></blockquote> </div> </article> <article> <h1>tinker運用ノート(3)</h1> Wed, 10 Apr 2013 00:00:00 +0900 <h1>tinker運用ノート(3)</h1> tinkerを運用するにあたっての覚え書き <a class="reference internal" href="https://www.mindto01s.com/2013/03/02/tinker_note_01.html">tinker運用ノート(1)</a> や <a class="reference internal" href="https://www.mindto01s.com/2013/04/09/cb30e421_d9c5_41ec_8e80_401f006f6227.html">tinker運用ノート(2)</a> の続き <div class="section" id="make"> <h2>makeファイルを作って、よく使うコマンドをまとめる</h2> アップロードしたり、プレビューしたりするのに毎回長いコマンドを打つのは面倒なのでMakefileにまとめる。こんな感じ。 <div class="highlight-makefile notranslate"><div class="highlight"><pre>PN := $(shell uuidgen) all : clean build clean : rm -rf ./blog/ cat : find . -name "*.rst" | xargs grep -e '^.. categories::' | cut -d':' -f4 | sort | uniq | tr -d ' ' tag : find . -name "*.rst" | xargs grep '^.. tags::' | cut -d':' -f4 | tr ',' '\n' | sort | uniq | tr -d ' ' build : tinker -b preview : build open index.html newPost : open `tinker -f -p "$(PN)"` upload : clean build rsync -av --exclude=.DS_Store --exclude=.buildinfo blog/html/ USER@EXAMPLE.COM:/HTML/DIR/PATH/ </pre></div> </div> 先日の <a class="reference internal" href="https://www.mindto01s.com/2013/04/09/e07883ff_504a_417b_922b_dfb4bce4c4f1.html">MacPortsでbash-completion</a> と組み合わせると、そのディレクトリだけで有効なコマンドが出来たみたいで快適。 uploadはサーバーへアップロードするコマンド。 newPostはblogに新しい記事を追加するコマンド。私の場合は、内容を書いてからタイトルを決める事が多いので、デフォルトではページ名はuuidで生成された文字列にしました。任意の名前にしたい場合は”PN=TitleString”を引数に付けると良い。日本語は不可。 </div> </article> <article> <h1>tinker運用ノート(2)</h1> Tue, 09 Apr 2013 00:00:00 +0900 <h1>tinker運用ノート(2)</h1> tinkerを運用するにあたっての覚え書き <a class="reference internal" href="https://www.mindto01s.com/2013/03/02/tinker_note_01.html">tinker運用ノート(1)</a> の続き <div class="section" id="id1"> <h2>リンクの張り方</h2> <div class="section" id="id2"> <h3>内部リンクの方法</h3> 拡張子なしでファイル名を書く。 <div class="highlight-rest notranslate"><div class="highlight"><pre>適当な文 :doc:`sample/index` と書くと、sample/index.rstへジャンプするリンクを書ける。 </pre></div> </div> と書く。リンク文の前後に空白を入れる事を忘れると認識してくれない。 絶対パスの例 <div class="highlight-rest notranslate"><div class="highlight"><pre>:doc:`/2013/01/01/doubutunomori` </pre></div> </div> 相対パスの例 <div class="highlight-rest notranslate"><div class="highlight"><pre>:doc:`../../01/01/doubutunomori` </pre></div> </div> </div> <div class="section" id="id3"> <h3>外部リンクの方法</h3> <div class="highlight-rest notranslate"><div class="highlight"><pre>`Sphinxを知りたい方はこちらをクリック <http://sphinx-users.jp>`_ </pre></div> </div> と書く。URLの直書きもOK。 リンク文の前後に空白を入れる事を忘れると認識してくれない。 詳しくは <a class="reference external" href="http://sphinx-users.jp/doc10/rest.html#id7">Sphinxのサイト</a> を参照する事。 </div> </div> </article> <article> <h1>MacPortsでbash-completion</h1> Tue, 09 Apr 2013 00:00:00 +0900 <h1>MacPortsでbash-completion</h1> makeファイルのターゲッットをコマンドライン補完したくなった。 調べるとbash-completionと呼ばれるスクリプトをインストールすると良いらしい事まで判った。 MacPortsでインストールしようと考えたら、デフォルトで入っているbashのバージョンが古いのでMacPotsで新しいbashに切り替える必要があるとの事。 面倒だなと思いつつインストールして設定する。 結果。大変快適。自動補完が無い環境にはもう戻れない。 <ul class="simple"> <li>参考URL</li> </ul> <a class="reference external" href="https://trac.macports.org/wiki/howto/bash-completion">How to use bash-completion</a> </article> <article> <h1>ヒレガス本　課題8-2</h1> Mon, 08 Apr 2013 00:00:00 +0900 <h1>ヒレガス本　課題8-2</h1> ヒレガス本第四版の課題8-2を読んで、この課題は10分も掛からないだろうと見積もりコーディングを始めるたが、デバッグに1時間もかかった。 ミスをした箇所は以下の通り。 <ul class="simple"> <li>NSButtonからtarget/actionの設定を忘れていた</li> </ul> <blockquote> <div>凡ミスだが、何度もボタンを押してしまった。最初に接続忘れを疑うべきだった。</div></blockquote> <ul class="simple"> <li>プロトコルのスペルミス</li> </ul> <blockquote> <div>NSTableViewDataSourceプロトコルの一部をスペルミスしていた。実装がoptionalだと警告が発生しないのでミスを発見しにくい。 対策は、NSTableView.hから該当するプロトコルメソッドをCopy&Pasteするのが一番だと思う。 </div></blockquote> <ul class="simple"> <li>[NSTableView reloadData]の呼出し忘れ</li> </ul> <blockquote> <div>arrayへの追加削除の後には、reloadDataしないと画面がアップデートしない。</div></blockquote> <ul class="simple"> <li>IB上でidentifierの設定忘れ</li> </ul> <blockquote> <div>tableCulumのidentifierを見て表示する内容を選んでいるのに、identifierが空だった。 identifierが空の時にassertを発生させた方が良いかも。</div></blockquote> <ul class="simple"> <li>tableCulumのidentifierをデータのKVCの名前に一致させるべきだったのを別の名前を作ってしまった。</li> </ul> <blockquote> <div>わざわざ変換ようのディクショナリを作ってから気がついた。CoreDataが出てくるまでは定型文だったのだがすっかり忘れていた。</div></blockquote> </article> <article> <h1>KeyValueCodingのメモ</h1> Mon, 08 Apr 2013 00:00:00 +0900 <h1>KeyValueCodingのメモ</h1> ヒレガス本の復習をして自分の間違いに気がついた。 今までアクセッサメソッドを手書きする時に、必ず[NSObject willChangeValueForKey:]と[NSObject didChangeValueForKey:]を呼出していた。 KVOでそのプロパティが自動変更通知を使用している場合には不要だった。 プロパティーをKVCやドット表記でアクセスした場合だけでなく、アクセッサメソッドにも自動で変更通知をする。 おそらく内部で、メソッドの置換えを行っていて、アクセッサメソッドの前後に[NSObject willChangeValueForKey:]と[NSObject didChangeValueForKey:]の呼び出しを追加しているようだ。 なお、パフォーマンスの改善等の理由でより細かく通知を制御したい場合は手動変更通知と呼ばれる方法が存在する。 <div class="highlight-objc notranslate"><div class="highlight"><pre>+ (BOOL) [NSObject automaticallyNotifiesObserversForKey:(NSString *)inKey] </pre></div> </div> をオーバーライドして、手動変更通知したいプロパティ名でNOを返すようにすると、そのプロパティ名は手動変更通知と見なされる。 手動変更通知にしたプロパティ名でKVOに対応させるには、アクセッサメソッドでwiiChangeValueForKeyとdidChangeValueForKeyの対を呼ばなければならない。 すいません。いままで知りませんでした。今までかなりパフォーマンスが悪いプログラムを各地で書いていたようです。本当にすいません。 <dl class="docutils"> <dt>参考文献</dt> <dd>ADCのKeyValueObserving.pdfとKeyValueCoding.pdfとヒレガス本</dd> </dl> </article> <article> <h1>20年物</h1> Thu, 07 Mar 2013 00:00:00 +0900 <h1>20年物</h1> 病院帰りに図書館へ寄った。書庫に保管されている20年程前の本を借りて家に帰った。 家でおもむろにページを捲ると、随所に鼻毛が挟まっていた。汚い。そう思ったが、気を取り直して読み進める。 しかし、その量が多過ぎた。 最初は、見開きに１本程の量で有ったが、読み進めて行くと１ページに４本程の量が挟まっているページが有る。 もの凄く汚い、読む気も失せた。気持ち悪いので、本をポリ袋に入れて部屋の片隅に置いた。 土日に返却しに行くつもり。何だか悲しい。 </article> <article> <h1>tinker運用ノート(1)</h1> Sat, 02 Mar 2013 00:00:00 +0900 <h1>tinker運用ノート(1)</h1> tinkerを運用するにあたっての覚え書き <div class="section" id="rest"> <h2>restの書き方</h2> sphinxのページより引用し、自分が使いそうな物だけを列挙する。 <div class="section" id="id1"> <h3>表の書き方</h3> <blockquote> <div><div class="highlight-rest notranslate"><div class="highlight"><pre>空の行 .. csv-table:: 表のタイトル :header: "ヘッダの", "タイトル" :widths: 25, 75 空の行 "セルA1", "せるB1" "セルA2", "せるB2" </pre></div> </div> と書くと <table border="1" class="colwidths-given docutils" id="id8"> <caption>表のタイトル</caption> <colgroup> <col width="25%"/> <col width="75%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">ヘッダの</th> <th class="head">タイトル</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>セルA1</td> <td>せるB1</td> </tr> <tr class="row-odd"><td>セルA2</td> <td>せるB2</td> </tr> </tbody> </table> の様に表示される。 </div></blockquote> </div> <div class="section" id="id2"> <h3>コードの書き方</h3> <blockquote> <div><div class="highlight-rest notranslate"><div class="highlight"><pre>空の行 .. code-block:: rest 空の行コード1 コード2 コード3 空の行 </pre></div> </div> と書くと <div class="highlight-rest notranslate"><div class="highlight"><pre>コード1 コード2 コード3 </pre></div> </div> の様に表示される。 </div></blockquote> </div> <div class="section" id="id3"> <h3>ダウンロード可能なファイルの指定</h3> <blockquote> <div><div class="highlight-rest notranslate"><div class="highlight"><pre>:download:`EnablerTest.zip <EnablerTest.zip>` </pre></div> </div> と書くとダウンロード用のリンクが出来る。インラインで書ける。多分前後に空白が必要。指定したファイルが無いと、build時にエラーが出る。 </div></blockquote> </div> <div class="section" id="id4"> <h3>画像の置き方</h3> <blockquote> <div><div class="highlight-rest notranslate"><div class="highlight"><pre>空の行 .. image:: ControlEnabler.png :scale: 50% 空の行 </pre></div> </div> と書くと画像を置ける。指定したファイルが無いと、build時にエラーが出る。 </div></blockquote> </div> </div> <div class="section" id="id5"> <h2>書いた文書から情報を引き出す</h2> <div class="section" id="id6"> <h3>カテゴリの種類</h3> <blockquote> <div>カテゴリ一覧を取得するには。()の中はメモです、出力されないです。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ find . -name "*.rst" | xargs grep 'categories::' | cut -d':' -f4 | sort | uniq | tr -d ' ' discovery <-- (発見) reference <-- (引用) study <-- (学習) note <-- (雑記) article <-- (記事) </pre></div> </div> </div></blockquote> </div> <div class="section" id="id7"> <h3>タグの種類(複数可能)</h3> <blockquote> <div>タグ一覧を取得を取得するには <div class="highlight-bash notranslate"><div class="highlight"><pre>$ find . -name "*.rst" | xargs grep 'tags::' | cut -d':' -f4 | tr ',' '\n' | sort | uniq | tr -d ' ' xcode cocoa ditzX graphics etc </pre></div> </div> </div></blockquote> </div> </div> </article> <article> <h1>グラフィックデザインの勉強その１</h1> Sat, 16 Feb 2013 00:00:00 +0900 <h1>グラフィックデザインの勉強その１</h1> ソフトウェア開発の分野では、デザインというと設計の事だが、世間一般ではグラフィックデザインの事を言うらしい。 設計は仕事でやった事はあるが、グラフィックデザインはやった事も無いし苦手。 素人なりに基本だけでも覚えておこうと本を買って来た。署名は「デザインの教室手を動かして学ぶデザイントレーニング」。 副題の”手を動かす”との事だが、最初の１章は座学だった。 <div class="section" id="id2"> <h2>まとめノート</h2> 私の知識で似た物を探すと、グラフィックデザインの基本はInterfaceBuilderの各種レイアウト機能に似てる。しかし対比と余白の項目はIB上に対応する機能はない。 <ul class="simple"> <li><dl class="first docutils"> <dt>特徴点</dt> <dd>オブジェクトの上下左右の端や中点。(どのように決めるかは言及していない)</dd> </dl> </li> <li><dl class="first docutils"> <dt>補助線</dt> <dd>特徴点を通るX軸またはY軸に平行な直線。</dd> </dl> </li> <li><dl class="first docutils"> <dt>整列</dt> <dd>異なるオブジェクトの特徴点同士をX軸やY軸方向に合わせる事。</dd> </dl> </li> <li><dl class="first docutils"> <dt>グリッドシステム</dt> <dd>グリッドに従いオブジェクトを配置する。変化をしつつ全体の統一感を出せる。</dd> </dl> </li> <li><dl class="first docutils"> <dt>繰返し</dt> <dd>異なるオブジェクトの特徴点の間隔を等間隔にする事。繰返しを知覚させるには３回以上の繰返しが必要。</dd> </dl> </li> <li><dl class="first docutils"> <dt>対比</dt> <dd>画像と本文や黒と白等とページをエリア分轄し、それぞれの部分に明確な役割を与える。メリハリが効いて良いらしい。</dd> </dl> </li> <li><dl class="first docutils"> <dt>余白</dt> <dd>強調する場所のまわりに余白をとる。強調する箇所を目立つ色や大きさにするのも良いが限界がある。余白によって強調効果が出せる。</dd> </dl> </li> <li><dl class="first docutils"> <dt>ルールを作る</dt> <dd>上記の要素を組み合わせて、局所的な俺様ルールを作るようにすると良いらしい。</dd> </dl> </li> </ul> </div> <div class="section" id="id3"> <h2>疑問</h2> <ul class="simple"> <li>特徴点はどうやって決めるのか？</li> </ul> <blockquote> <div>不連続な点や極値の点を特徴点として良いのだろうか？</div></blockquote> <ul class="simple"> <li>グリッドシステムは構造化出来そう</li> </ul> <blockquote> <div>オブジェクト毎の特徴点の摘出とグリッド配置を再帰的に適応すると、もっと汎用性が高まると思う。</div></blockquote> </div> <div class="section" id="id4"> <h2>感想とか</h2> これを１週間に2〜3時間程行い半年くらいすれば基本は身に付くのだろうか？道のりが遠過ぎて途中で挫折しそう。 プログラミングの学習と違いデザインの学習はループが閉じていない気がする。 </div> </article> <article> <h1>sourceコマンド</h1> Wed, 13 Feb 2013 00:00:00 +0900 <h1>sourceコマンド</h1> unixコマンドをもう一度勉強してみようと思い、本を広げた。十数ページも読み進まないうちに、初めて知る事が書いてあり、未熟を悟る。 <ol class="arabic"> <li>bashのsourceコマンド <blockquote> <div>“socrce file”と行うと、そのfileをスクリプトとして実行される。 “bash file”との違いは、新規にプロセスを生成するか否かの違い。 socrceは同じプロセスでシェルスクリプトを実行する。 bashは子プロセスでシェルスクリプトを実行する。 この違いにより、socrceは環境変数の上書き等に利用される。 bashは返り値しか元のプロセスに返さないので環境変数を書き散らかしても問題ない。 </div></blockquote> </li> <li>bashのシングルクオーテーション(‘)とダブルクオーテーション(“) <blockquote> <div>bashではコマンドライン上に特定の文字が有ると、コマンドの評価に先立ってその文字列を展開する。展開される文字は、”*”, “?”, “`”等。 シングルクオーテーション(‘)とダブルクオーテーション(“)で囲む事は、それらの特殊な文字を展開させずにコマンドに渡す為の手段。これをクォーティングと言う。 ２つのクォーティングの違いは、展開を許す文字列の違い。 シングルクオーテーションは展開を許さない。 ダブルクオーテーションは、変数展開”${VAR}”やコマンド展開”`”の展開を許す。 </div></blockquote> </li> </ol> </article> <article> <h1>コンパイラフラグ</h1> Tue, 05 Feb 2013 00:00:00 +0900 <h1>コンパイラフラグ</h1> XCode4でファイル毎のコンパイルフラグを設定するには以下の場所で設定する。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/complierFlag.png"></a> 実際に使うのは以下の２つくらい。 <ul class="simple"> <li>arcをファイル毎にON/OFFする時</li> </ul> <blockquote> <div>“-fobjc-arc” / “-fno-objc-arc”</div></blockquote> <ul class="simple"> <li>最適化をファイル毎に変更する時</li> </ul> <blockquote> <div>“-O0”(なし)から”-o3”(速い)、あるいは”-Os”(速くて小さい)。</div></blockquote> プロジェクト全体を”-Os”が設定されている時、デバッグがうまく出来ない事がある。そんな時に、その特定のファイルだけ”-O0”にすると良いかもしれない。 </article> <article> <h1>Objective-Cのsingleton</h1> Mon, 04 Feb 2013 00:00:00 +0900 <h1>Objective-Cのsingleton</h1> 「Objective‐Cフレーズブック」のSingletonの部分の記述が面白い。 p75より <blockquote> <div>Appleのドキュメントでは、シングルトンを作成する為に、+sharedInstanceメソッドの中で@synchronized(sefl)を使用する事を推奨しています。そのアプローチは著しく遅く、このセクションで提案したアプローチよりも多くのコードが必要なため、あまりお勧めしません。</div></blockquote> との事。 Appleのやり方、<a class="reference external" href="https://developer.apple.com/jp/documentation/Cocoa/Conceptual/CocoaFundamentals/CocoaObjects/chapter_3_section_10.html">「シングルトンインスタンスの作成」</a> を見ると <div class="highlight-objc notranslate"><div class="highlight"><pre>static MyGizmoClass *sharedGizmoManager = nil; + (MyGizmoClass*)sharedManager { @synchronized(self) { if (sharedGizmoManager == nil) { [[self alloc] init]; // ここでは代入していない } } return sharedGizmoManager; } + (id)allocWithZone:(NSZone *)zone { { @synchronized(self) { if (sharedGizmoManager == nil) { sharedGizmoManager = [super allocWithZone:zone]; return sharedGizmoManager; // 最初の割り当てで代入し、返す } } return nil; // 以降の割り当てではnilを返すようにする } . . . </pre></div> </div> となっており、確かに+ (MyGizmoClass*)sharedManagerで@synchronized(self)を使用している。 一方、「Objective‐Cフレーズブック」のやり方は、 <div class="highlight-objc notranslate"><div class="highlight"><pre>static MyGizmoClass *sharedGizmoManager = nil; + (void) initialize { if( [MyGizmoClass class] == self ) { sharedGizmoManager = [self new]; } } + (MyGizmoClass*)sharedManager { return sharedGizmoManager; } + (id)allocWithZone:(NSZone *)zone { { if( sharedGizmoManager && [MyGizmoClass class] == self ) { [NSException raise:NSGenericException format:@"May not create more than one instance of singleton."]; } return [super allocWithZone:zone]; } . . . </pre></div> </div> となっており、@synchronizedがなく、全体的にすっきりしたコードだ。 しかし、脚注にGCCのランタイムにはバグがあって「Objective‐Cフレーズブック」のやり方は動作しないような事が書いてある。 結論としては、gccを使う場合はAppleの推奨する方法を使うのが良いとの事だろうか。 </article> <article> <h1>メソッド名合成を使ったプログラミング(1)</h1> Sat, 02 Feb 2013 00:00:00 +0900 <h1>メソッド名合成を使ったプログラミング(1)</h1> 「メソッド名合成を使ったプログラミング(1)」の続き <div class="section" id="id2"> <h2>メソッド名合成プログラミングその２</h2> Cocoaライブラリの例以外には、Cocoa勉強会関東57回目で発表した「五年後のControlEnabler」でもメソッド名合成を使ってプログラミングしている。 このControlEnablerでは、target-actionパラダイムを利用して、NSControlのサブクラスの挙動を変更する仕組みです。 target-actionパラダイムでは、変数targetによって示されるオブジェクトへ変数actionによって示されるメソッドを呼出します。 関係は以下の図のように、ボタンからコントローラへの一方通行。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/target-action.png"></a> </div></blockquote> ここで、ControlEnablerを導入しすると、windowのupdateのタイミングでボタンはコントローラのデータを読み取り、ボタンの挙動を変更する。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ControlEnabler.png"></a> </div></blockquote> target-actionパラダイムでtargetとして指定されたオブジェクトは、actionを実行出来るのだから”おそらく”actionに関する他の事柄も知っているだろう、言う前提の仕組みです。 ここで、コントローラにactionメソッドとして “anAction:”が有るとすると、以下のメソッドを定義する事でbuttonの挙動を変更出来ます。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) anAction:(id)sender; // action - (BOOL) canAnAction:(id)sender; // actionを呼出すボタンの有効無効を制御 - (NSString*)titleOfAnAction:(id)sender; // actionを呼出すボタンのタイトルを制御 </pre></div> </div> ここで、上記のように”anAction:”を共通の文字列として、can<action名>、titleOf<action名>といったメソッド名を合成して、update毎に呼出してその値をボタン自身に適応する。 ControlEnablerでは、このようなメソッド名合成を使ったプログラミングを使用している。 </div> <div class="section" id="id3"> <h2>メソッド名合成プログラミングその３</h2> その他にも状態遷移クラス等の設計等で使えると思うけど、作ってません。 “<状態名>Enter”や”<状態名>Exit”等のメソッド名を合成してデリゲートを呼出せば、switch分が減る。 </div> </article> <article> <h1>ヘビーノベル</h1> Fri, 01 Feb 2013 00:00:00 +0900 <h1>ヘビーノベル</h1> ライトノベルがあるならヘビーノベルもあるのかもしれない。 大江健三郎がQJをシャウトする、そんなイメージ。 </article> <article> <h1>「NSInvocationをカテゴリで拡張した」の修正</h1> Thu, 31 Jan 2013 00:00:00 +0900 <h1>「NSInvocationをカテゴリで拡張した」の修正</h1> 以前の、「NSInvocationをカテゴリで拡張した」の修正。 詳解Objective-C 2.0 第三版 P537より、KVCで自動変換出来る構造体は、 <blockquote> <div>自動的に受け渡し出来るのはCocoaで標準的に使われている四種類の構造体 NSPoint, NSRange, NSRect, NSSizeに限られています。</div></blockquote> との事なので、NSPoint, NSRange, NSRect, NSSizeの四つの構造体をサポートするように変更する。 if文の固まりの末尾に、以下を追加した。 <div class="highlight-objc notranslate"><div class="highlight"><pre>else if( 0 == strcmp(theReturnType, @encode(NSPoint)) ) { theResult = [NSValue valueWithPoint:*(NSPoint*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(NSSize)) ) { theResult = [NSValue valueWithSize:*(NSSize*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(NSRect)) ) { theResult = [NSValue valueWithRect:*(NSRect*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(NSRange)) ) { theResult = [NSValue valueWithRange:*(NSRange*)thePtr]; } else { theResult = [NSValue valueWithBytes:thePtr objCType:theReturnType]; } </pre></div> </div> 以上のサポートでKVCで標準でサポートしている型の自動変換をサポートしたハズ。 </article> <article> <h1>メソッド名合成を使ったプログラミング(1)</h1> Wed, 30 Jan 2013 00:00:00 +0900 <h1>メソッド名合成を使ったプログラミング(1)</h1> Objective-Cでは文字列型NSStringとセレクタ型SELを相互に変換出来る。この変換機能で実行時に生成した文字列からメソッドを呼び出す事が可能になる。 スクリプト言語では当たり前の機能だが、コンパイル言語でこのような機能があるのは少ない。 ここで、文字列からメソッド名を合成する事、その合成したメソッドを積極的に使ったコーディングをそれぞれ、「メソッド名合成」及び「メソッド名合成プログラミング」と命名する事にする。 <div class="section" id="id2"> <h2>メソッド名合成</h2> 文字列型NSStringとセレクタ型SELの相互変換関数として、以下の２つがある。 <div class="highlight-objc notranslate"><div class="highlight"><pre>NSString *NSStringFromSelector(SEL aSelector); SEL NSSelectorFromString(NSString *aSelectorName); </pre></div> </div> 文字列からSEL型を作るのはもちろん、SEL型も文字列型に変換後は編集可能になる。編集した文字列型を再びSEL型に戻せば、SEL型の編集も可能と見なせる。 単純な例として、プロパティ名からsetterメソッドを合成する関数を示す。 <div class="highlight-objc notranslate"><div class="highlight"><pre>SEL setterSelectorFromName(NSString* inName) { NSString* theResultString; theResultString = [NSString stringWithFormat:@"set%@:", [inName stringByReplacingCharactersInRange:NSMakeRange(0,1) withString:[[inName substringToIndex:1] uppercaseString]]]; return NSSelectorFromString(theResultString); } </pre></div> </div> この関数は、@”test”を渡すと@selector(setTest:)を返す動作をする。 </div> <div class="section" id="id3"> <h2>合成したメソッドの呼び出し</h2> プロトコルや非公式プロトコルのメソッドと同じように、合成したメソッドは対象となるオブジェクトにメソッドの実装があるとは保証されていない。 よって、セレクタが呼び出し可能かを確認後呼び出しをしなければならない。 コードとしては、以下のようになる。 <div class="highlight-objc notranslate"><div class="highlight"><pre>if( [self respondsToSelector:theSelector] ) { [self performSelector:theSelector withObject:theObject]; } </pre></div> </div> これはデリゲートやプロトコルを使ったプログラミングと同じようになる。 すこしだけ異なるのは、プロトコルと違いメソッド名は動的に決まるので、[NSObject performSelector:]やNSInvocationを使ったメソッド呼び出しを行う事になる。 </div> <div class="section" id="id4"> <h2>メソッド名合成プログラミング</h2> メソッド名合成プログラミングの応用例がCocoaのフレームワークの中にある。ここでは、判り易い例としてkey値コーディングのインディックス付きアクセッサを示す。 インディックス付きアクセッサは以下の２つのメソッドをサポートする必要がある。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (NSInteger) countOf_KEY_; - (id) objectIn_KEY_AtIndex:(NSInteger)index; </pre></div> </div> ここで、”_KEY_”はkey値コーディングでいうキー文字列が入る。 この２つのメソッドを定義すると、そのオブジェクトはkey値コーディング上ではプロパティ_KEY_を持っているように振る舞う事が出来る。 プロトコルと異なり、_KEY_は任意の文字列に出来る。実行時に対で実装されていれば実行出来る。 同じような例として、プロパティ値の検証用メソッドがある。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (BOOL) validate_KEY_:(id*)ioValue error:(NSError**)outError; </pre></div> </div> ここでも、”_KEY_”はkey値コーディングでいうキー文字列が入る。 これらの例のように、Cocoaでは「メソッド名合成を使ったプログラミング」は既に使われている。 つづく。 </div> </article> <article> <h1>validateuserinterfaceitem(8)</h1> Tue, 29 Jan 2013 00:00:00 +0900 <h1>validateuserinterfaceitem(8)</h1> NSUserInterfaceValidationsプロトコルは、CocoaのUIの状態を更新する仕組みを提供するプロトコルだ。 UIにはNSToolbar、NSMenu、NSView、NSControlのサブクラス群が含まれる。 メニューのenable/disableやチェックマークを付ける等の状態を更新する、OpenStep時代のNSMenuActionResponder非公式プロトコルを発展させた物だと思われる。 NSUserInterfaceValidationsプロトコルは、NSToolbar用のNSToolbarItemValidationプロトコルや、NSMenu用のNSMenuValidationプロトコルを統一的に扱う為の物なのだろう。 ここで問題なのは、NSToolbarやNSMenuにはautovalidates等のプロパティがあり、自動で更新処理を行う事が出来る。 しかし、NSViewやNSControlには自動で更新を行う仕組みは無い。 当初、私は個々のNSControlのサブクラスで、”NSWindowDidUpdateNotification”をとらえて更新させるコードを書いていた。 この方式の欠点はNibエディター上でUIを配置する毎に、Class名を書き換える必要があり煩雑である事だった。 この欠点を解消する為に、Notificationを個々のcontrolでとらえるのではなく、NSWindowのupdateメソッドをオーバーライドして、個々のcontrolの状態を更新する方法に変更した。 NSWindowとNSPanelのサブクラスをそれぞれ作る事で実現している。 コードは以下の通り、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/MTLUserInterfaceValidationUpdate.zip" download="">MTLUserInterfaceValidationUpdate.zip</a> </article> <article> <h1>NSWindowのupdateメソッドについてのメモ</h1> Mon, 28 Jan 2013 00:00:00 +0900 <h1>NSWindowのupdateメソッドについてのメモ</h1> <ul class="simple"> <li>NSWindowのupdateメソッドは、NSWindowDidUpdateNotificationnを通知センターにポストする以外の処理は行わない。</li> <li>NSApplicationのupdateWindowsメソッドを呼び出す事で、アプリケーション内の全てのNSWindowに対してupdateメソッドを呼び出す事が出来る。</li> <li>イベントループが一回転するたびに、NSWindowのupdateメソッドは呼ばれる。</li> <li>updateメソッドが呼ばれるタイミングはNSWindowが再描画される前。</li> <li>NSWindowのサブクラスでは、updateメソッドをオーバーライドして、モデルデータの内容を各種UIに反映する事が出来る。</li> </ul> これらの事を考えると、各種コントロールをアップデートするには、 <ul class="simple"> <li>NSWindowのupdateメソッドをオーバーライドする。</li> <li>windowに乗っている全てのview(control)に対して、NSUserInterfaceValidationsプロトコルに基づく更新作業を行う。</li> </ul> と言うのがCocoa的に正しいUI更新の方法かもしれない。 MenuやToolbarはデフォルトでこのような更新メカニズムが実装されている。 NSControlにそのような仕組みが無いのは、歴史的理由とCPUパワーの問題と思われる。 現状ではCPUパワーは有り余っている。よってイベントループ毎にcontrolを更新しても問題ないと、私は判断し実装する事にする。 <div class="section" id="id1"> <h2>参考文献</h2> OpenStepリファレンス </div> </article> <article> <h1>CSS設定の上書き</h1> Sun, 27 Jan 2013 00:00:00 +0900 <h1>CSS設定の上書き</h1> このサイトの構築に、sphinxだとかtinkerを使用している。見出し文字の行間を調整したいのだが、何処の値を変更すれば良いのか判らなかった。 ビルド結果のファイル”_static/modern5.css”中の以下の記述を変更すれば良い事までは判った。 この記述を <div class="highlight-css notranslate"><div class="highlight"><pre>article.document h1 { font-size: 2.2em; } article.document h2 { font-size: 1.8em; } article.document h3 { font-size: 1.2em; } </pre></div> </div> こうして、line-heightを足せば <div class="highlight-css notranslate"><div class="highlight"><pre>article.document h1 { font-size: 2.2em; line-height: 1.2;} article.document h2 { font-size: 1.8em; line-height: 1.2;} article.document h3 { font-size: 1.2em; line-height: 1.2;} </pre></div> </div> みっともない、行間を修正出来た。 しかし、ビルド毎にファイル”_static/modern5.css”は上書きされてしまう。 仕方ないので、modern5を継承した独自テーマのcssの末尾に上記のCSSの修正したコードを貼付けた。 結果的にmodern5の値はcss的には上書きされたようで、レイアウトは変更されたがコレがsphinx/tinker的に正しい解決方法なのかは不明。 </article> <article> <h1>Cocoa勉強会関東57回目</h1> Sat, 26 Jan 2013 00:00:00 +0900 <h1>Cocoa勉強会関東57回目</h1> validateuserinterfaceitemの内容をまとめて、「五年後のControlEnabler」をCocoa勉強会で発表してきました。 内容が練り込まれていない事もあり、あまり評判はよろしく無いようでした。 CocoaSQLMapperの発表を聞きたかったのですが後半は事情により欠席。 </article> <article> <h1>validateuserinterfaceitem(7)</h1> Fri, 25 Jan 2013 00:00:00 +0900 <h1>validateuserinterfaceitem(7)</h1> Cocoa勉強会用の資料として、「五年後のControlEnabler」をまとめた。 validateuserinterfaceitemをうまく使って、NSControlの挙動を変かえるコードです。 サンプルコードは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/narita_20130125.zip" download="">narita_20130125.zip</a> PDFは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/Controlenabler.pdf" download="">Controlenabler.pdf</a> </article> <article> <h1>uncrustifyおかわり</h1> Thu, 24 Jan 2013 00:00:00 +0900 <h1>uncrustifyおかわり</h1> <div class="section" id="id1"> <h2>はじめに</h2> uncrustifyはObjective-Cに対応したソースコードの整形ツールです。 以前にCocoa勉強会での発表時から時間がたち、uncrustifyのObjective-C対応が進みました。また、XCodeのバージョンも進みuncrustifyを呼び出す方法が変わりました。 現在のuncrustifyとXCodeのバージョンにあった設定と手法を紹介します。 </div> <div class="section" id="id2"> <h2>開発環境</h2> 開発環境は以下の通りです <table class="docutils field-list" frame="void" rules="none"> <col class="field-name"/> <col class="field-body"/> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">MacOSX:</th><td class="field-body">10.8.2</td> </tr> <tr class="field-even field"><th class="field-name">XCode:</th><td class="field-body">4.5.2</td> </tr> <tr class="field-odd field"><th class="field-name">uncrustify:</th><td class="field-body">0.59</td> </tr> </tbody> </table> </div> <div class="section" id="id3"> <h2>インストール</h2> MacPortsにパッケージがありますので、これを使います。インストール方法は以下の通りです。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ sudo port install uncrustify </pre></div> </div> </div> <div class="section" id="id4"> <h2>主な使用方法</h2> uncrustifyは単純なコマンドラインのプログラムです。以下の様にして、整形したいファイルを指定するだけです。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ uncrustify [options] [files ...] </pre></div> </div> 主に使うオプションは以下の通りです。 <table class="docutils option-list" frame="void" rules="none"> <col class="option"/> <col class="description"/> <tbody valign="top"> <tr><td class="option-group"> <kbd>-c <var>CFG</var></kbd></td> <td>設定ファイルCFGを使う</td></tr> <tr><td class="option-group"> <kbd>-f <var>FILE</var></kbd></td> <td>FILEを入力ファイルとして扱う</td></tr> <tr><td class="option-group"> <kbd>-o <var>FILE</var></kbd></td> <td>出力をFILEに書き出す。</td></tr> <tr><td class="option-group"> <kbd>-F <var>FILE</var></kbd></td> <td>FILEに1行毎にファイルパスを書いておくと一括で処理。</td></tr> <tr><td class="option-group"> <kbd>--replace</kbd></td> <td>入力ファイルを出力結果で置換える。(バックアップは取る)</td></tr> <tr><td class="option-group"> <kbd>--no-backup</kbd></td> <td>入力ファイルを置換えてバックアップは取らない。</td></tr> <tr><td class="option-group"> <kbd>-l <var>OC</var></kbd></td> <td>言語の指定。Objective-CはOC、Objective-C++はOC+。</td></tr> </tbody> </table> 整形フォーマットは設定ファイルで指定します。 </div> <div class="section" id="id5"> <h2>設定ファイルの設置</h2> MacPortsでインストールした場合は、”/opt/local/share/uncrustify/”に設定ファイルのサンプルがおいてあります。これらの設定をコピペして変更しながら使うとお好みの形式に近づけられます。 設定ファイルの項目数は400個くらいあります。全体を眺めるのに必要な略語を以下に示します。 略語一覧 <table border="1" class="docutils"> <colgroup> <col width="19%"/> <col width="81%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">略語</th> <th class="head">意味</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>indent</td> <td>行の最初のインデント関連</td> </tr> <tr class="row-odd"><td>sp</td> <td>要素間の空白関連</td> </tr> <tr class="row-even"><td>align</td> <td>桁揃え関連。変数宣言等で型と変数名を縦方向にそろえるとか</td> </tr> <tr class="row-odd"><td>nl</td> <td>改行関連</td> </tr> <tr class="row-even"><td>mod</td> <td>順序をsortしたり、{}を追加したり等のコードを変更をする</td> </tr> <tr class="row-odd"><td>cmd</td> <td>コメントの中身の改変</td> </tr> <tr class="row-even"><td>pp</td> <td>プリプロセッサ関連</td> </tr> <tr class="row-odd"><td>oc</td> <td>Objective-C関連</td> </tr> </tbody> </table> Objective-Cに関連する項目を次の表に示します。 sp_xxxx系の項目はお好みで。 <table border="1" class="docutils"> <colgroup> <col width="20%"/> <col width="80%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">項目</th> <th class="head">設定値</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>sp_before_oc_colon</td> <td>メッセージ式の’:’の前に空白を挿入/削除する</td> </tr> <tr class="row-odd"><td>sp_after_oc_colon</td> <td>-(int) f:(int) x;と-(int) f: (int) x;の様に:と型名の間にスペースを入れるか否か</td> </tr> <tr class="row-even"><td>sp_after_oc_scope</td> <td>-(void)foo;や+(int)bar;の+-等の記号の後にスペースを入れるか否か</td> </tr> <tr class="row-odd"><td>sp_after_oc_type</td> <td>メッセージ式の引数の型名の後に空白を挿入/削除する</td> </tr> <tr class="row-even"><td>sp_after_oc_return_type</td> <td>-(void) foo;等の型と関数名の間にスペースを入れるか否か</td> </tr> <tr class="row-odd"><td>sp_before_send_oc_colon</td> <td>‘[object setValue:1];’ vs ‘[object setValue :1];’これremoveじゃないとダメだろ</td> </tr> <tr class="row-even"><td>sp_after_send_oc_colon</td> <td>‘[object setValue:1];’ vs ‘[object setValue: 1];’普通は左側</td> </tr> <tr class="row-odd"><td>sp_after_oc_at_sel</td> <td>‘@selector(msgName)’ vs <a class="reference external" href="mailto:'%40selector">‘@selector</a> (msgName)’‘普通は左側</td> </tr> <tr class="row-even"><td>sp_before_oc_block_caret</td> <td>‘^int (int arg){…}’ vs. ‘ ^int (int arg){…}’</td> </tr> <tr class="row-odd"><td>sp_after_oc_block_caret</td> <td>‘^int (int arg){…}’ vs. ‘^ int (int arg){…}’</td> </tr> <tr class="row-even"><td>align_oc_msg_colon_span</td> <td># Obj-C message on the ‘:’ but stop after this many lines (0=don’t align)</td> </tr> <tr class="row-odd"><td>align_oc_msg_spec_span</td> <td># the span for aligning ObjC msg spec (0=don’t align)</td> </tr> <tr class="row-even"><td>align_oc_decl_colon</td> <td># Aligning parameters in an Obj-C ‘+’ or ‘-‘ declaration on the ‘:’</td> </tr> </tbody> </table> </div> <div class="section" id="id6"> <h2>コマンドラインからの使い方</h2> MacPortsでインストールした場合は、”/opt/local/share/uncrustify/”に設定ファイルのサンプルがおいてあります。以下のような感じで”/opt/local/share/uncrustify/”以下の設定ファイルを色々と試して、好みに近い物を探すと最初から設定ファイルを手書きするより楽です。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ uncrustify -l OC -c /opt/local/share/uncrustify/kr-indent.cfg testClass.m </pre></div> </div> 実行するとtestClass.m.uncrustifyが出来たと思いますので、diffをとって変更された箇所を確認してください。 さらに、以下のようにopeddiffすればビジュアルに変更点を確認出来きて便利です。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ uncrustify -l OC -c /opt/local/share/uncrustify/kr-indent.cfg testClass.m $ opendiff testClass.m testClass.m.uncrustify </pre></div> </div> FileMerge.appが開いてこんな感じになります。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/opediff.tiff"></a> </div> <div class="section" id="xcode4"> <h2>XCode4からの使い方</h2> XCode3の時に使えたScriptMenuが使えなくなったので、以下の２種類の方法があるようです。 <ul class="simple"> <li><dl class="first docutils"> <dt>ビヘイビアを使う</dt> <dd><a class="reference external" href="http://robertjpayne.com/post/9092159751/using-uncrustify-directly-in-xcode-4">http://robertjpayne.com/post/9092159751/using-uncrustify-directly-in-xcode-4</a></dd> </dl> </li> <li><dl class="first docutils"> <dt>サービスメニューからAppleScriptかAutometerを使う</dt> <dd><a class="reference external" href="http://blog.carbonfive.com/2011/03/10/code-formatting-in-xcode-4/">http://blog.carbonfive.com/2011/03/10/code-formatting-in-xcode-4/</a></dd> </dl> </li> </ul> 残念ながら私には能力が無いのでどちらも試していません。 XCodeのビヘイビアもAppleScriptもAutometrも全部使った事が無いのです。 そのうち試して追記します。 </div> <div class="section" id="id7"> <h2>参考文献</h2> <dl class="docutils"> <dt>公式サイト</dt> <dd><a class="reference external" href="http://uncrustify.sourceforge.net/">http://uncrustify.sourceforge.net/</a></dd> <dt>オプションの日本語解説</dt> <dd><a class="reference external" href="http://www.6809.net/tenk/?PG%BB%A8%B5%AD%2fUncrustify%A4%CE%A5%AA%A5%D7%A5%B7%A5%E7%A5%F3">http://www.6809.net/tenk/?PG%BB%A8%B5%AD%2fUncrustify%A4%CE%A5%AA%A5%D7%A5%B7%A5%E7%A5%F3</a></dd> <dt>設定ファイルの例</dt> <dd><a class="reference external" href="https://github.com/tonyarnold/energon/blob/master/uncrustify.cfg">https://github.com/tonyarnold/energon/blob/master/uncrustify.cfg</a> <a class="reference external" href="https://github.com/tonyarnold/energon/commits/master/uncrustify.cfg">https://github.com/tonyarnold/energon/commits/master/uncrustify.cfg</a> <a class="reference external" href="https://gist.github.com/954967">https://gist.github.com/954967</a></dd> </dl> </div> </article> <article> <h1>XCode4でのnib編集時のTarget/Actionの扱い</h1> Wed, 23 Jan 2013 00:00:00 +0900 <h1>XCode4でのnib編集時のTarget/Actionの扱い</h1> 以前のInterfaceBuilderで使っていたテクニックが使えなくなっていた。 InterfaceBuilderではtarget/actionパラダイムで接続出来るクラスは、以下の４つのメソッドがヘッダに定義されていれば問題なく使えた。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (id)target; - (void)setTarget:(id)anObject; - (SEL)action; - (void)setAction:(SEL)aSelector; </pre></div> </div> 上記の４つのメソッドの有無で、IBActionConnectionでコネクションを張れるかどうかを判断していたらしい。 XCode4でこのテクニックは使えない。代わりに以下のような手法を使う。 <ol class="arabic"> <li>actionセレクタを文字列で設定するメソッドを追加する <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)setActionName:(NSString*)inActionName { self.action = NSSelectorFromString(inActionName); } - (NSString*)actionName { return NSStringFromSelector(_action); } </pre></div> </div> </div></blockquote> </li> <li>ヘッダにtargetをIBOutletを付ける <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>@property (retain) IBOutlet id target; </pre></div> </div> </div></blockquote> </li> </ol> <blockquote> <div>XCode4上のUIエディターで通常のconnectionとして接続する事でtargetの設定が出来きる。</div></blockquote> <ol class="arabic simple" start="3"> <li>XCode4上でセレクタ名を設定する</li> </ol> <blockquote> <div>“Identify Inspector”の”User Defined Runtime Attributes”に <blockquote> <div><table border="1" class="colwidths-given docutils"> <colgroup> <col width="50%"/> <col width="50%"/> </colgroup> <tbody valign="top"> <tr class="row-odd"><td>key Path</td> <td>actionName</td> </tr> <tr class="row-even"><td>Type</td> <td>String</td> </tr> <tr class="row-odd"><td>Value</td> <td><selectorNameString></td> </tr> </tbody> </table> </div></blockquote> と設定する。これで、nibの読込み完了時にactionが設定される。 </div></blockquote> <div class="section" id="id1"> <h2>参考文献</h2> <a class="reference external" href="http://www.cocoabuilder.com/archive/cocoa/311698-making-target-action-of-view-visible-to-ib.html">http://www.cocoabuilder.com/archive/cocoa/311698-making-target-action-of-view-visible-to-ib.html</a> </div> </article> <article> <h1>メニューのアップデート</h1> Tue, 22 Jan 2013 00:00:00 +0900 <h1>メニューのアップデート</h1> 先日の問題の続き。 Application delegateで <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)applicationDidUpdate:(NSNotification *)notification { [[NSApp mainMenu] update]; } </pre></div> </div> と行えば、メニューの状態をメニューバーのクリック前に随時更新する。らしい。 NSLogで挙動を見る限り、更新作業をオンタイムで行っている。 が、ここで更に問題が有った。と言うよりも、私自身の問題認識が間違っている。 NSMenuは所有するNSMenuItemが全てDisableでもNSMenu自身はDisableになる訳ではない。 そもそも、OpenStepでは、MacOSの流儀と違ってSubMenuが選択出来ないからといって、Menuを選択出来ないようにする文化が無いのかもしれない。 </article> <article> <h1>NSMenuItemの更新のタイミング</h1> Mon, 21 Jan 2013 00:00:00 +0900 <h1>NSMenuItemの更新のタイミング</h1> NSMenuItemの更新のタイミング、[NSUserInterfaceValidations validateUserInterfaceItem:(id)anItem]が呼ばれるタイミングは、マウスがNSPopupMenuをクリックした時だった。 NSPopupMenuのmenuを表示する直前に更新処理をするのは、更新処理を必要最小限にする為と思われる。 理にかなっていると思うのだが、１点マズい事がある。 menuItemが全てDisableの場合は、NSPopupMenuもDisableにする必要がある。しかし、更新のタイミングがNSPopupMenuをクリックする時だと奇妙な挙動が起る。 ユーザーが、NSPopupMenuをクリックした瞬間に、クリックしたNSPopupMenuがDisableに変わってしまう。(1/22追記この認識自体が間違い) 解決方法は、更新処理をNSPopupMenuをクリックした時ではなく、NSWindowDidUpdateNotificationが飛んで来た時に更新すると良いと思われる。 コードは、色々と失敗したので挫折した。 </article> <article> <h1>Cocoa bindingが行われているかのチェック方法</h1> Sun, 20 Jan 2013 00:00:00 +0900 <h1>Cocoa bindingが行われているかのチェック方法</h1> [NSObject infoForBinding:バインディング名]で確認出来る。 nilで有ればbindingがされていない。nil以外の場合はbindingに関する詳細な情報がディクショナリ形式で返ってくる。 </article> <article> <h1>NSInvocationをカテゴリで拡張した</h1> Sat, 19 Jan 2013 00:00:00 +0900 <h1>NSInvocationをカテゴリで拡張した</h1> [NSObject valueForKey:(NSString*)inKey]はプリミティブ型をNSNumberやNSValueでラップする。 つまりKVCを使うと、ラップ済みのオブジェクトを取得する事が出来る。ただし、この場合呼出すメソッドに引数が有ってはならない。 引数がある場合はどうするか？NSInvocationを使えば出来る。 但し、[NSInvocation getReturnValue:(void*)inPtr]で取得出来る返り値の型(void*)だ。この返り値の型は、[NSInvocation methodReturnType]で取得出来る。当然プリミティブ型も含まれる。 この２つの値を参照してObject型を返すようなメソッドを作った。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@implementation NSInvocation (MTLAddition) - (id) objectWrappedReturnValue { NSMethodSignature* theSignature = [self methodSignature]; const char* theReturnType = [theSignature methodReturnType]; void* thePtr = malloc([theSignature methodReturnLength]); [self getReturnValue:thePtr]; id theResult = nil; if( 0 == strcmp(theReturnType, @encode(id)) ) { theResult = *(id*)thePtr; } else if( 0 == strcmp(theReturnType, @encode(Class)) ) { theResult = *(Class*)thePtr; } else if( 0 == strcmp(theReturnType, @encode(char)) ) { theResult = [NSNumber numberWithChar:*(char*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(unsigned char)) ) { theResult = [NSNumber numberWithUnsignedChar:*(unsigned char*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(short)) ) { theResult = [NSNumber numberWithShort:*(short*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(unsigned short)) ) { theResult = [NSNumber numberWithUnsignedShort:*(unsigned short*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(int)) ) { theResult = [NSNumber numberWithInt:*(int*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(unsigned int)) ) { theResult = [NSNumber numberWithUnsignedInt:*(unsigned int*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(long)) ) { theResult = [NSNumber numberWithLong:*(long*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(unsigned long)) ) { theResult = [NSNumber numberWithUnsignedLong:*(unsigned long*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(long long)) ) { theResult = [NSNumber numberWithLongLong:*(long long*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(unsigned long long)) ) { theResult = [NSNumber numberWithUnsignedLongLong:*(unsigned long long*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(float)) ) { theResult = [NSNumber numberWithFloat:*(float*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(double)) ) { theResult = [NSNumber numberWithDouble:*(double*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(BOOL)) ) { theResult = [NSNumber numberWithBool:*(BOOL*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(NSInteger)) ) { theResult = [NSNumber numberWithInteger:*(NSInteger*)thePtr]; } else if( 0 == strcmp(theReturnType, @encode(NSUInteger)) ) { theResult = [NSNumber numberWithUnsignedInteger:*(NSUInteger*)thePtr]; } else { theResult = [NSValue valueWithBytes:thePtr objCType:theReturnType]; } free(thePtr); return theResult; } @end </pre></div> </div> コードを見れば判るようにid型、Class型、NSNumberでサポートしているプリミティブ型の三つしか対応していない。 それ以外は、[NSValue valueWithBytes:(void*)inPtr objCType:(const char*)inType]を使っている。 かなりおおざっぱな実装だが、私の用途には十分だった。ポインター型、構造体、配列型、blocks型等も実装するべきなのだろうが、やり方が判らなかった。 </article> <article> <h1>保険金Getだぜ！！</h1> Fri, 18 Jan 2013 00:00:00 +0900 <h1>保険金Getだぜ！！</h1> 保険屋さんから書類が来た。この間の雪で壊れた雨どいの修理費の書類。 築30年ごえのボロ屋に住んでる貧乏人にとっては、この手の火災保険の保険金は有り難い。 毎年の支払額を考えると損するのだろうが、修理費が定額になるので計画が立て易くなるのが利点。 なお、修理費の見積もりが終わってないので本当はまだ保険金はゲット出来ていません。 </article> <article> <h1>Cのマクロでは部分文字列は出来ない</h1> Thu, 17 Jan 2013 00:00:00 +0900 <h1>Cのマクロでは部分文字列は出来ない</h1> ObjC上で、似たようなコードを沢山書いていたのでマクロを使おうとした。 <div class="highlight-objc notranslate"><div class="highlight"><pre>id objectWrappingFrom(void* inPtr, const char* inType) { id theResult = nil; if( strcmp(@encode(char), inType) ) { theResult = [NSNumber numberWithChar:*(char*)inPtr]; } else if( strcmp(@encode(unsigned char), inType) ) { theResult = [NSNumber numberWithUnsignedChar:*(unsigned char*)inPtr]; }// こんなのが沢山 . . . . else { theResult = [NSValue valueWithBytes:inPtr objCType:inType]; } return theResult; } </pre></div> </div> NSNumberのメソッド名中の型名、@encode中の型名、キャストの型名が微妙に違う。メソッド名の型名だけcamelCaseになっている。 これをマクロで記述しようと一日中頑張ったが私の能力では無理だった。 Cのマクロでは文字列から部分文字列を取り出せないらしい。文字列の結合は##で出来るが、文字列を切り分ける方法が無い。 1/18日追記 上のコードは思いきり間違い。 strcmpは文字列が等しい時に0を返すので、 <div class="highlight-objc notranslate"><div class="highlight"><pre>id objectWrappingFrom(void* inPtr, const char* inType) { id theResult = nil; if( strcmp(@encode(char), inType) == 0) // <--- コレ { theResult = [NSNumber numberWithChar:*(char*)inPtr]; } . . . </pre></div> </div> としなければならない。 </article> <article> <h1>筋肉痛</h1> Wed, 16 Jan 2013 00:00:00 +0900 <h1>筋肉痛</h1> 昨日の雪かきで体中が痛い。普段の運動不足を痛感する。 雨どいの破損の保険は査定が来るとの事。 今日のお仕事の成果は無し。 </article> <article> <h1>雪害</h1> Tue, 15 Jan 2013 00:00:00 +0900 <h1>雪害</h1> 午後9時半過ぎに突然おおきな音が聞こえた。最初は地震か？と思ったが揺れていない。 外に出てみると、昼間に雪かきをしてキレイした北側の道路に雪が積もっている。どうやら屋根から雪が落ちて来たようだ。 道路に誰もおらず事故にならずに良かった。と思っていたら、雨どいが雪に持って行かれて壊れていた。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/snow_damage.jpg"></a> </div></blockquote> エアコンの室外機や湯沸器にも雪があたってカバーが凹んでいるが一応動いている。雨どいの方はもう、雨どいの役割を果たしてないな。 日本生命の火災保険と家財保険に入っているのだが、雪害は保険がおりるのだろうか？明日、保険のおばちゃんに聞いてみよう。 </article> <article> <h1>NSSegmentedControlで最後にクリックされたセグメントのタグ番号を得るには</h1> Mon, 14 Jan 2013 00:00:00 +0900 <h1>NSSegmentedControlで最後にクリックされたセグメントのタグ番号を得るには</h1> NSSegmentedControlで最後にクリックされたセグメントのタグ番号を得るには、[NSSegmentedControl selectedTag]で取得出来そうだが、実際には出来ない。 このメソッドで帰ってくる値は、segmentに設定されたタグではなくNSSegmentedControlのタグ。 これはおそらく、 <blockquote> <div><ol class="arabic simple"> <li>segmentはcellではない</li> <li>segmentは複数選択が可能である</li> </ol> </div></blockquote> の２点の理由で、意図的にそのような仕様になったのだと思われる。 クリックされたセグメントに設定されたtagを得るには以下のコードを追加して、[NSSegmentedControl lastClikedSegmentedTag]を呼出せば良い。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@implementation NSSegmentedControl (MTLControlItemEnabler) - (NSInteger) lastClikedSegmentedTag { NSSegmentedCell* theCell = [self cell]; return [theCell tagForSegment:[theCell selectedSegment]];; } @end </pre></div> </div> </article> <article> <h1>なぜObjective-Cの拡張子が”m”なのか？</h1> Sun, 13 Jan 2013 00:00:00 +0900 <h1>なぜObjective-Cの拡張子が”m”なのか？</h1> 理由は既に忘れ去られたらしい。 Objective-Cの作者Brad Coxによると「モジュール」、「メソッド」、「メッセージ」かも知れないとの事。 プログラミングって結構いい加減だと再認識した。 <div class="section" id="id1"> <h2>参考文献</h2> Objective-C フレーズブック P21 </div> </article> <article> <h1>LEDランタンを購入</h1> Sat, 12 Jan 2013 00:00:00 +0900 <h1>LEDランタンを購入</h1> 無印良品の「LEDランタン・サーチライト付」を購入しようと近所の店舗によったが、在庫が無いとの事。 諦めて家でググると、パナソニックから同様の製品が発売されていた。製品名は「無接点インテリアライト BG-KL01H-W」。 色々と調べると、OEMの製品でブランドが異なるだけでほぼ同一の製品と考えて良いようだ。早速Amazonで注文して手元に届いて現在使用中。 値段の割には使い物にならないのは、Amazonの評価通りなので気にならず。 充電中にかすかに小さな音がする。インバーターか何かが働いている音なのだろうが、気になる人は気になるかもしれない。 この手の普段使いできる防災用品というジャンルの商品がスキなのでもう少し増えてくれると有り難い。 なお、私にとっての「普段使いできる防災用品」のヒット商品は <ul class="simple"> <li>カセットコンロ</li> </ul> <blockquote> <div>冬にコレで鍋物を作るのが大好きです。</div></blockquote> <ul class="simple"> <li>封筒型寝袋</li> </ul> <blockquote> <div>膝掛けやクッションとして年中つかってます。</div></blockquote> <ul class="simple"> <li>LEDキーライト</li> </ul> <blockquote> <div>キーライトとしては大型の単四電池を使う物です。普段は暗くなってからの足下を照らしてます。帰り道に犬のウンコが転がってるので踏んづけない為には必須です:-)</div></blockquote> </article> <article> <h1>カテゴリを使ってプロトコルの後付け</h1> Fri, 11 Jan 2013 00:00:00 +0900 <h1>カテゴリを使ってプロトコルの後付け</h1> Objective-Cでは、ひとまとまりのメソッド群が実装されているかを実行時に調べる方法として、プロトコルと呼ばれる物がある。 私は、まず「プロトコル」が存在し、それに対して「プロトコルに適応されたクラス」が存在すると考えていた。 しかし、Objective-Cでは、既存のクラスを後付けでプロトコルに適応出来ました。 以下のコードを実行するとログに”:-D”が表示されます。 <div class="highlight-objc notranslate"><div class="highlight"><pre>#import "PTAppDelegate.h" // プロトコルの定義 @protocol PTObjectValueProtocol - (void)setObjectValue:(id<NSCopying>)obj; - (id)objectValue; @end // プロトコルを後付けするカテゴリ @interface NSControl (PTAppDelegate) <PTObjectValueProtocol> @end </pre></div> </div> <div class="highlight-objc notranslate"><div class="highlight"><pre>// 後付けしたプロトコルの実装 @implementation NSControl (PTAppDelegate) @end @implementation PTAppDelegate - (void)applicationDidFinishLaunching:(NSNotification *)aNotification { // "protocol(PTObjectValueProtocol)"の部分は@protocolです。 // sphinxがうまくコードを色づけしてくれなかったので@を抜かしました。 if( [NSButton conformsToProtocol:protocol(PTObjectValueProtocol) ] ) { NSLog(@":-D"); } else { NSLog(@":-("); } } @end </pre></div> </div> 基本的に、 <blockquote> <div><ul class="simple"> <li>“@interface 既存クラス名 (カテゴリ名) <プロトコル名>”</li> <li>“@implementation 既存クラス名 (カテゴリ名)”</li> </ul> </div></blockquote> の２つを作るだけで問題なくプロトコル対応なクラスとして認識してくれました。 </article> <article> <h1>久しぶりに神保町</h1> Thu, 10 Jan 2013 00:00:00 +0900 <h1>久しぶりに神保町</h1> 先日、仕事帰りに神保町の明倫館書店に行った。 店の中を物色していると、床の上に積まれている本の中に欲しい物が有った。 値段はいくらなのか店員に尋ねると、整理中なので触らないで欲しいとの事。 次に寄り道する時には売れてしまっているのだろうなと思いつつ店を出る。 </article> <article> <h1>validateuserinterfaceitem(6)</h1> Wed, 09 Jan 2013 00:00:00 +0900 <h1>validateuserinterfaceitem(6)</h1> 続き。 NSMatrixやNSForm等の複数のNSCellのインスタンスを持つControlの取り扱いに難儀中。 NSMenuItem, NSToolBarItem, NSButton等は”- (IBAction) action:(id)sender”の引数にそれぞれのObjectが来る。 選択余地はないのでこれは正しい。 しかし、NSMatrixはsenderにNSMatrixが入るのは正しいのだろうか？もちろんCocoaの実装では、NSMatrixが入っている。 Radioボタン等はtagをとる為に、NSCellがsenderに入るのが”正しい”気がするのだが。 今日は眠いので寝る。 </article> <article> <h1>validateUserInterfaceItem(5)</h1> Tue, 08 Jan 2013 00:00:00 +0900 <h1>validateUserInterfaceItem(5)</h1> さらに続き。 <div class="section" id="mtlcontrolitemenabler"> <h2>MTLControlItemEnablerをもっと拡張する</h2> 以下の属性のアップデートにも対応した。 <ul class="simple"> <li>attributedTitle</li> <li>objectValue</li> <li>stringValue</li> <li>attributedStringValue</li> <li>toolTip</li> </ul> </div> <div class="section" id="nsmatrix"> <h2>NSMatrixに対応出来ていない</h2> MTLControlItemEnablerはNSMatrixに対応出来ていません。ラジオボタングループのstateを変更が出来ません。 おそらく、NSMatrixのサブクラスでMTLButtonのようにupdateをする事と、matrix内部のcellのstateを変更するように拡張すれば動くと思われる。 が、まだ手つかず。 </div> <div class="section" id="id1"> <h2>サンプルコード</h2> かなり中途半端だが、一応UPする <a class="reference download internal" href="https://www.mindto01s.com/_downloads/EnablerTest-4.zip" download="">EnablerTest-4.zip</a> </div> </article> <article> <h1>ガンプラ</h1> Mon, 07 Jan 2013 00:00:00 +0900 <h1>ガンプラ</h1> お年玉として、甥っ子に正月にガンプラを買ってあげた。 彼の話によると、最近のガンダムの敵は火星人なのだそうだ。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/martian.jpg"></a> </div></blockquote> 昔のガンダムのイメージとはかなりかけ離れている感じがする。 </article> <article> <h1>validateUserInterfaceItem(4)</h1> Sun, 06 Jan 2013 00:00:00 +0900 <h1>validateUserInterfaceItem(4)</h1> 前回の更に続き。 <div class="section" id="mtlcontrolitemenabler"> <h2>MTLControlItemEnablerとは何か？</h2> MTLControlItemEnablerはコードを簡潔に表記する事を目的に書かれました。 UIの挙動を宣言的に表記出来ます。 例えば、メソッド”xyzAction:”を呼出すボタンのenable/disableを制御するには、”canXyzAction:”を定義します。 “canXyzAction:”の返り値でenable/disableを制御します。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) xyzAction:(id)sender { // 色々と実行 } - (BOOL) canXyzAction:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return YES or NO; } </pre></div> </div> “canXyzAction:”の呼び出しは、”validateUserInterfaceItem:”で”controlItemEnabler:”を呼出すと内部で適当に呼出します。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (BOOL)validateUserInterfaceItem:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return [self controlItemEnabler:anItem]; } </pre></div> </div> </div> <div class="section" id="id1"> <h2>MTLControlItemEnablerを拡張する</h2> さらに今回のコードでは、もう一歩進めて以下のUIの挙動を変更出来ます。 <blockquote> <div><ul class="simple"> <li>state</li> </ul> <blockquote> <div>NSMixedState, NSOffState, NSOnState等の値でチェックBOXやラジオボタンのON/OFFやメニューのチェック等を制御します。</div></blockquote> <ul class="simple"> <li>image</li> </ul> <blockquote> <div>buttunやToolboxItemやMenuItemの画像を制御します。例えば、音楽プレーヤーアプリのPlay/Stopを一つのボタンので行い画像を随時入れ替える場合等に使えます。</div></blockquote> <ul class="simple"> <li>title</li> </ul> <blockquote> <div>ButtonやMenuItemのタイトル文字列を変更出来ます。</div></blockquote> <ul class="simple"> <li>label</li> </ul> <blockquote> <div>toolbarItemは何故かtitle属性がなくlabel属性になっていたので追加。</div></blockquote> </div></blockquote> メソッド”xyzAction:”が有った場合は、以下のようにメソッド名にprefixを付けたメソッドを作成します。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) xyzAction:(id)sender { // 色々と実行 } - (BOOL) canXyzAction:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return YES or NO; } - (NSIntger) stateOfXyzAction:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return NSMixedState;//NSMixedState or NSOffState or NSOnState; } - (NSImage*) imageOfXyzAction:(id)anItem { if( func() ) return [NSImage imageNamed:NSImageNameIconViewTemplate]; else return [NSImage imageNamed:NSImageNameListViewTemplate]; } - (NSString*) titleOfXyzAction:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return [NSString stringWithFormat:@"xyz(%li)", 1/*適当な数字とか*/]; } </pre></div> </div> </div> <div class="section" id="id2"> <h2>サンプルコード</h2> プロジェクトファイルはここ、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/EnablerTest-3.zip" download="">EnablerTest-3.zip</a> 最初は以下のようになってます。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss011.tiff"></a> </div></blockquote> action1のボタン(titleOfで置換えているので、enable(x)となってるが)を押すと、titleやimageが変わります。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss021.tiff"></a> </div></blockquote> action2のボタンを押すと、また変わります。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss031.tiff"></a> </div></blockquote> action3を押すともとに戻ります。 コードの解説は特に無し。zipを解凍してみてみてください。 </div> </article> <article> <h1>validateUserInterfaceItem(3)</h1> Sat, 05 Jan 2013 00:00:00 +0900 <h1>validateUserInterfaceItem(3)</h1> 前回の更に続き。 今回は、NSControlの方を変更するのではなく、”validateUserInterfaceItem:”の記述の仕方の説明。 しかも、ノーマルな”validateUserInterfaceItem:”の記述方法ではなくて、私がより簡潔だと考えている記述方法です。 <div class="section" id="validateuserinterfaceitem"> <h2>validateUserInterfaceItem:とは何か？</h2> UIの有効無効を制御するCocoa標準の手法です。validateUserInterfaceItem登場以前には、toolbarやmenu等でそれぞれ異なったメソッドを使用していた。 現在は、validateUserInterfaceItemを実装する事を推奨している。 validateUserInterfaceItemの役割は、 <ul class="simple"> <li>UI有効無効を制御</li> <li>UIにチェックマークを付ける</li> <li>UIにtooltipの設定</li> </ul> 等です。 Cocoa標準の表記法では <div class="highlight-objc notranslate"><div class="highlight"><pre>- (BOOL)validateUserInterfaceItem:(id <NSValidatedUserInterfaceItem>)anItem { BOOL theResult = NO; if([anItem action] == @selector(saveAction:)) { theResult = YES or NO; } else if([anItem action] == @selector(action2:)) { theResult = YES or NO; } return theResult; // or NO } </pre></div> </div> と、こんな感じで表記します。 </div> <div class="section" id="id1"> <h2>validateUserInterfaceItem:の表記法の問題点は何か？</h2> プログラムコードを書く時には、関連するコードは近い場所に書くべきと言われています。しかし、この標準的な書き方では関係ある物はまとめたいのに、actionのメソッドと有効にするためのロジックが以下のように離れてしまいます。 <div class="highlight-objc notranslate"><div class="highlight"><pre>// UIから実行したいメソッド - (IBAction) saveAction:(id)sender { . . . } . . . - (IBAction) action2:(id)sender { . . . } . . . - (BOOL)validateUserInterfaceItem:(id <NSValidatedUserInterfaceItem>)anItem { BOOL theResult = NO; // saveAction:のenable/disableの制御 if([anItem action] == @selector(saveAction:)) { theResult = YES or NO; } // action2:のenable/disableの制御 else if([anItem action] == @selector(action2:)) { . . . . . . } return theResult; } </pre></div> </div> また、validateUserInterfaceItem:メソッドの中の、if-else-ifが延々と続くのも可読性が悪くなります。 </div> <div class="section" id="id2"> <h2>解決方法は？</h2> 解決方法は単純です。 UIから呼出されるaction:メソッドとUIのenable/disableを決定するロジックを記述するcanActionメソッドの２つを対にして実装します。これで２つのコードが離れる事を防げます。 次に、if-else-ifが延々と続くのを防ぐ為に、validateUserInterfaceItem:でaction:メソッドからcanActionメソッドを動的に探すコードを書けば解決出来ます。 これが、 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (BOOL)validateUserInterfaceItem:(id <NSValidatedUserInterfaceItem>)anItem { BOOL theResult = NO; if([anItem action] == @selector(saveAction:)) { theResult = [self canSaveAction:anItem]; } else if([anItem action] == @selector(action2:)) { theResult = [self canAction2:anItem]; } else if([anItem action] == @selector(action3:)) { theResult = [self canAction3:anItem]; } else if([anItem action] == @selector(action4:)) { theResult = [self canAction4:anItem]; } return theResult; // or NO } </pre></div> </div> こうなります。 <div class="highlight-objc notranslate"><div class="highlight"><pre>#import "NSObject(MTLControlItemEnabler).h" . . . - (BOOL)validateUserInterfaceItem:(NSObject<NSValidatedUserInterfaceItem>*)anItem { // controlItemEnablerで全部面倒見ます return [self controlItemEnabler:anItem]; } </pre></div> </div> actionとcanActionメソッドは、例えば以下のように一カ所に表記出来ます。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction) saveAction:(id)sender { NSError *error = nil; if (![[self managedObjectContext] save:&error]) { [[NSApplication sharedApplication] presentError:error]; } } - (BOOL) canSaveAction:(NSObject<NSValidatedUserInterfaceItem>*)anItem { return [[self managedObjectContext] hasChanges]; } </pre></div> </div> サンプルコードは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/EnablerTest-2.zip" download="">EnablerTest-2.zip</a> </div> </article> <article> <h1>validateUserInterfaceItem(2)</h1> Fri, 04 Jan 2013 00:00:00 +0900 <h1>validateUserInterfaceItem(2)</h1> 前回の続き。サンプルアプリを作った。 MTLButtonがToolbarItemやMenuItemのように、UIのenable/disableを自動で行うのを確認出来る。 AppDelegateのvalidateUserInterfaceItemで順繰りに特定のactionを持つToolbarItemやMenuItemをenable/disableを行っている。 MTLButtonではWindowがアップデートされるタイミングで、このvalidateUserInterfaceItemを呼出して自分自身のenable/disableを変更している。 Action1のselectorを持つUIがenableになっている。NSButtonはvalidateUserInterfaceItemに対応していないので、全てenableになっている。しかし、MTLButton, ToolbarItem, MenuItemはAction1しかenableになっていない。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss01.tiff"></a> </div></blockquote> action2をenableにした場合。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss02.tiff"></a> </div></blockquote> action3をenableにした場合。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/ss03.tiff"></a> </div></blockquote> サンプルコードは、 <a class="reference download internal" href="https://www.mindto01s.com/_downloads/EnablerTest.zip" download="">EnablerTest.zip</a> </article> <article> <h1>validateUserInterfaceItem(1)</h1> Thu, 03 Jan 2013 00:00:00 +0900 <h1>validateUserInterfaceItem(1)</h1> メニューとツールバーの有効/無効を制御するプロトコルとして”NSUserInterfaceValidations”がある。 これをNSButtonに対して拡張する手法がある。2006年〜2007年頃に書いたコードだ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface MTLButton : NSButton { } - (void) updateEnableState; @end @implementation MTLButton - (id)initWithFrame:(NSRect)frameRect { self = [self initWithFrame:frameRect]; if(self) { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(updateEnableState) name:NSWindowDidUpdateNotification object:nil]; } return self; } - (void) dealloc { [self subviews]; [[NSNotificationCenter defaultCenter] removeObserver:self]; [super dealloc]; } - (id) initWithCoder: (NSCoder*)aDecoder { self = [super initWithCoder: aDecoder]; if(self != nil) { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(updateEnableState) name:NSWindowDidUpdateNotification object:nil]; } return self; } - (void) updateEnableState { // actionが設定されているかをチェック。(target == nil)の場合はfirstResponderだから有効なのでtargetのnilチェックはしない。 if( [self action] != nil && [self window] != nil && [self isHiddenOrHasHiddenAncestor] == NO) { id theValidator; // レスポンダーチェーンをたどって実際にactionを処理するオブジェクトを探す。そのオブジェクトがメニューやボタンのenable/disableの値を決定出来るはず theValidator = [NSApp targetForAction:[self action] to:[self target] from:self]; if([self infoForBinding:@"enabled"]) { // enabledにCocoaBindingが設定されている場合は // CocoaBindingの設定を優先させるために何もしない。 } else if ((theValidator == nil) || ![theValidator respondsToSelector:[self action]]) { // actionを実行できるレスポンダーが無い場合は、ボタンは押せない [self setEnabled:NO]; } else if ([theValidator respondsToSelector:@selector(validateToolbarItem:)]) { // actionを実行できるレスポンダーが"validateToolbarItem:"を実装しているならば従う [self setEnabled: [theValidator validateToolbarItem: (NSToolbarItem*)self]]; } else if ([theValidator respondsToSelector:@selector(validateUserInterfaceItem:)]) { // actionを実行できるレスポンダーが"validateUserInterfaceItem:"を実装しているならば従う [self setEnabled: [(id<NSUserInterfaceValidations>)theValidator validateUserInterfaceItem: (id<NSValidatedUserInterfaceItem>)self]]; } else { // レスポンダーがあるけど、"validateXXXX"系のメソッドが無い場合は、ボタンは押せる。 [self setEnabled:YES]; } } } @end </pre></div> </div> 最近、仕事でiOSでなくCocoaのコードを書く事があり気がついた。このコードのNotificationを登録する箇所と値が間違っている。 <ol class="arabic simple"> <li>登録する場所は、 “[MTLButton viewDidMoveToWindow]”で行われるべき。</li> <li>登録解除する場所は、”[MTLButton viewWillMoveToWindow:newWindow]”で行われるべき。</li> <li>Notification登録時にButtonが乗っているWindowでフィルタリングするべき。</li> </ol> そんな訳で、 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (id)initWithFrame:(NSRect)frameRect; - (void) dealloc; - (id) initWithCoder: (NSCoder*)aDecoder; </pre></div> </div> は削除され、以下のコードで置換えるべきだと思うのだが、まだ実装してません。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (void)viewDidMoveToWindow { [super viewDidMoveToWindow]; NSWindow* theWindow = [self window]; if( theWindow != nil ) { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(updateEnableState) name:NSWindowDidUpdateNotification object:theWindow]; } } - (void)viewWillMoveToWindow:(NSWindow *)newWindow { [super viewWillMoveToWindow:newWindow]; NSWindow* theWindow = [self window]; if( theWindow != nil ) { [[NSNotificationCenter defaultCenter] removeObserver:self name:NSWindowDidUpdateNotification object:theWindow]; } } </pre></div> </div> ひょっとしたら、windowが放棄される時に”viewWillMoveToWindow:newWindow”が呼ばれないかもしれない。が、もう寝る。 </article> <article> <h1>NSWindowControllerとESCキー</h1> Wed, 02 Jan 2013 00:00:00 +0900 <h1>NSWindowControllerとESCキー</h1> 眠れぬ夜のために : OS X 用 Cocoa アプリケーションにおける環境設定ウィンドウの作り方( <a class="reference external" href="http://forthesleeplessnight.blogspot.jp/2012/10/os-x-cocoa.html">http://forthesleeplessnight.blogspot.jp/2012/10/os-x-cocoa.html</a>)では、環境設定ウィンドウをESCキーでクローズする動作を、NSWindowのサブクラス化で実現している。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface PreferencesWindow : NSWindow @end @implementation PreferencesWindow - (void) cancelOperation:(id)sender { [self close]; } @end </pre></div> </div> 個人的にはNSWindowではなく、NSWindowControllerで以下のように実装するのが好みだ。 <div class="highlight-objc notranslate"><div class="highlight"><pre>@interface PreferencesWindowController : NSWindowController @end @implementation PreferencesWindowController - (IBAction) cancel:(id)sender { [self close]; } @end </pre></div> </div> delegateで拡張できるならば、subclass化よりもdelegateで拡張する方がCocoaらしいと思っています。 </article> <article> <h1>とびだせどうぶつの森</h1> Tue, 01 Jan 2013 00:00:00 +0900 <h1>とびだせどうぶつの森</h1> このゲームのタイトルを聞いて、「とびだせ！カティンの森」を思いついた。 ググったら、すでに同じ事を思いついた善良な人々がおられて感動した。 </article> <article> <h1>ディレクトリレイアウトのメモ</h1> Mon, 31 Dec 2012 00:00:00 +0900 <h1>ディレクトリレイアウトのメモ</h1> プロジェクトを始めるにあたって、毎回悩むディレクトリレイアウトです。一部ではファイル構成管理と言うようですが、もっと狭い意味での構成管理です。 ファイル構成管理と言うと、svnやgitのようなバージョン管理を思い浮かべるかもしれないですが、ここではファイルとディレクトリをどのように配置するかを書いています。 私はSubversion実践入門で紹介されていたレイアウトを使っています。 <blockquote> <div><div class="highlight-default notranslate"><div class="highlight"><pre>BUILDING <--- ビルドする方法を書いたメモ GLOSSARY <--- プロジェクト特有の用語集 README <--- このプロジェクトが何なのか説明したメモ bugs/ <--- ditzのissueを入れるディレクトリ data/ <--- 本番用/テスト用のデータファイル等 doc/ <--- プロジェクトに関するドキュメント src/ <--- ソースコード util/ <--- プロジェクト特有の各種ツールやscript vendor/ <--- サードパーティ製のライブラリ等 vendorsrc/ <--- サードパーティ製のライブラリのソースコード </pre></div> </div> </div></blockquote> <ul class="simple"> <li>BUILDING</li> </ul> <blockquote> <div>ビルドする方法を書いたメモを書くとの事です。内容は、ビルドに必要な環境とビルド方法を書いたメモです。 <div class="highlight-default notranslate"><div class="highlight"><pre>必要条件： Xcode 4.5.2 MacOSX 10.8.2 ビルドの方法： cd ./src/ make 詳細情報： ./doc/building.html </pre></div> </div> しかし、このメモが必要になった時には、あまり役には立ちませんでした。 XCodeのバージョンが合わなかったり、OSのバージョンアップで各種ツールの位置が変わったりしていたため、結局XCodeのプロジェクトやmakeファイルの中身を書き換える事になりました。 </div></blockquote> <ul class="simple"> <li>GLOSSARY</li> </ul> <blockquote> <div>プロジェクト特有の用語をまとめて書くと良いと言われてますが、私は一度も書いた事はありません。多分、複雑で大規模なコードを書く人たちには重要なのかもしれません。</div></blockquote> <ul class="simple"> <li>README</li> </ul> <blockquote> <div>このプロジェクトが何なのか説明したメモ。 GitHubにあるプロジェクトのREADMEを参考にすると良いだろうと思ってますが、未だに書いた事がありません。</div></blockquote> <ul class="simple"> <li>bugs/</li> </ul> <blockquote> <div>ditzのissueを入れるディレクトリ。ditz initで作成してます。今回初めて作りました。</div></blockquote> <ul class="simple"> <li>data/</li> </ul> <blockquote> <div>本番用/テスト用のデータファイル等を入れるらしい。が、これも使った事無いです。</div></blockquote> <ul class="simple"> <li>doc/</li> </ul> <blockquote> <div>プロジェクトに関するドキュメントを入れる。議事録、設計メモ、メールでのやり取り、運用マニュアル等を入れておきます。読んでおくべき参考文献等もPDFやWebArchiveフォーマットで入れておくと、探す手間が省けて便利でした。</div></blockquote> <ul class="simple"> <li>src/</li> </ul> <blockquote> <div>プログラムのソースコー本体です。</div></blockquote> <ul class="simple"> <li>util/</li> </ul> <blockquote> <div>プロジェクト特有の各種ツールやscriptを入れておきます。意外に使います。私の場合は、 <ul class="simple"> <li>deleteDotSVN.sh</li> </ul> <blockquote> <div>出荷用パッケージに.svnデイレクトリが残らないようにするためのスクリプト</div></blockquote> <ul class="simple"> <li>openUp</li> </ul> <blockquote> <div>diskImageの”first-open-window”属性をONにするプログラム。Apple製</div></blockquote> <ul class="simple"> <li>make_svn_version_h.sh</li> </ul> <blockquote> <div>カレントディレクトリ上にsvnversionの値をc文法で定義するファイルのsvn_version.hを生成する。ビルド番号を生成を補助するツール</div></blockquote> 等を入れたり入れなかったりしてます。 </div></blockquote> <ul class="simple"> <li>vendor/</li> </ul> <blockquote> <div>サードパーティ製のライブラリを入れておきます。例えば、YAML.framework等を入れたりします。</div></blockquote> <ul class="simple"> <li>vendorsrc/</li> </ul> <blockquote> <div>サードパーティ製のライブラリのソースコードを入れておきます。例えば、YAML.frameworkのソースを入れたりします。毎回ビルドする物ではないので、ビルドした成果物は、vendorに入れてバージョン管理下に加えておきます。</div></blockquote> </article> <article> <h1>SCEvents</h1> Sun, 30 Dec 2012 00:00:00 +0900 <h1>SCEvents</h1> ファイル監視をする為にFSEventの事を調べてみたらSCEventsとクラスを発見。 CoreFoundationを使うよりも楽そうなのでこのコードを使用する事にする。 SCEventsのSCContstans.hで定義されている列挙型SCEventFlagsの定義が少したらないのようなので以下のように付け足して運用してみる事にした。 <div class="highlight-c notranslate"><div class="highlight"><pre>typedef enum { SCEventStreamEventFlagNone = 0x00000000, SCEventStreamEventFlagMustScanSubDirs = 0x00000001, SCEventStreamEventFlagUserDropped = 0x00000002, SCEventStreamEventFlagKernelDropped = 0x00000004, SCEventStreamEventFlagEventIdsWrapped = 0x00000008, SCEventStreamEventFlagHistoryDone = 0x00000010, SCEventStreamEventFlagRootChanged = 0x00000020, SCEventStreamEventFlagMount = 0x00000040, SCEventStreamEventFlagUnmount = 0x00000080 // 以下追加分 SCEventStreamEventFlagItemCreated = 0x00000100, SCEventStreamEventFlagItemRemoved = 0x00000200, SCEventStreamEventFlagItemInodeMetaMod = 0x00000400, SCEventStreamEventFlagItemRenamed = 0x00000800, SCEventStreamEventFlagItemModified = 0x00001000, SCEventStreamEventFlagItemFinderInfoMod = 0x00002000, SCEventStreamEventFlagItemChangeOwner = 0x00004000, SCEventStreamEventFlagItemXattrMod = 0x00008000, SCEventStreamEventFlagItemIsFile = 0x00010000, SCEventStreamEventFlagItemIsDir = 0x00020000, SCEventStreamEventFlagItemIsSymlink = 0x00040000 } SCEventFlags; </pre></div> </div> なお、”日暮れて道遠し”ではシングルトンであるとの事でしたが、複数のインスタンスを作成出来た。 間違いかもしれないが、そのまま使用してみるつもり。 <div class="section" id="id1"> <h2>参考文献</h2> <dl class="docutils"> <dt>日暮れて道遠し: Cocoa FSEvent と SCEvents</dt> <dd>“<a class="reference external" href="http://michitoshi.blogspot.jp/2011/06/cocoa-fsevent-scevents.html">http://michitoshi.blogspot.jp/2011/06/cocoa-fsevent-scevents.html</a>”</dd> <dt>本家</dt> <dd><a class="reference external" href="http://stuconnolly.com/blog/scevents-011/">http://stuconnolly.com/blog/scevents-011/</a></dd> </dl> </div> </article> <article> <h1>NSTaskで対話型コマンドを呼出す</h1> Sat, 29 Dec 2012 00:00:00 +0900 <h1>NSTaskで対話型コマンドを呼出す</h1> ditzをCocoaから呼出す方法を調べていた。 ditzはユーザーと対話しながら実行するサブコマンドが多い。 そのためNSTaskで実装するには、ユーザーからの入力を偽装するNSPipeをNSTaskに接続し、適切なタイミングで文字列を流し込む必要がある。 その正攻法では面倒だし、コードが判りにくいと思っていたら面白いUnixコマンドを見つけた。 “expect”と呼ばれるunixコマンドです。このexpectは対話型のUnixコマンドを操作する為のunixコマンドと言うべき物でした。 詳細は以下のURLを参照してください。 <dl class="docutils"> <dt>Expect 入門 :</dt> <dd><a class="reference external" href="http://nsa.kpu-m.ac.jp/gijutu/expect/doc-expect.php">http://nsa.kpu-m.ac.jp/gijutu/expect/doc-expect.php</a></dd> </dl> ditzをexceptを使って操作すれば、NSTaskへ投げっぱなしで問題なく実行出来そうだ。 例えば、以下のようなditzでissueを追加するラッパーを作った。 <table border="1" class="colwidths-given docutils"> <colgroup> <col width="50%"/> <col width="50%"/> </colgroup> <tbody valign="top"> <tr class="row-odd"><td>コマンド名</td> <td>addIssue.sh</td> </tr> <tr class="row-even"><td>引数１</td> <td>タイトル</td> </tr> <tr class="row-odd"><td>引数２</td> <td>詳細</td> </tr> <tr class="row-even"><td>引数３</td> <td>bugか機能かタスクか</td> </tr> <tr class="row-odd"><td>引数４</td> <td>作成者名</td> </tr> <tr class="row-even"><td>引数５</td> <td>コメント</td> </tr> </tbody> </table> 呼出し方はこう <div class="highlight-bash notranslate"><div class="highlight"><pre>$ ./addIssue.sh すごいバグ詳しく説明 b mymail@address 色々とコメント </pre></div> </div> ソースコードはこう <div class="highlight-bash notranslate"><div class="highlight"><pre>#!/bin/sh TITLE=$1 DESCRIPTION=$2 BFT=$3 CREATOR=$4 COMMENT=$5 expect -c " set timeout 5 spawn ditz add expect \"Title:\" send $TITLE send \"\n\" expect \"Description (\*):\" send $DESCRIPTION send \"\n\" send \".\" send \"\n\" expect \"Is this a (b)ugfix, a (f)eature, or a (t)ask? \" send $BFT send \"\n\" expect \"Issue creator (enter for \*):\" send $CREATOR send \"\n\" expect \"Comments (\*):\" send $COMMENT send \"\n\" send \".\" send \"\n\" interact " </pre></div> </div> こんなコマンドをbundleに持たせて、NSTaskで呼出せばCocoaでややこしいプログラムを組まなくて良さそうです。 ついでに、issueの追加ではなくてtaskの追加専用のコマンドにしてみたり、エラーチェックを追加してみた。。 <div class="highlight-bash notranslate"><div class="highlight"><pre>#!/bin/sh #################### # 事前条件チェック #################### # 引数の数をチェック if [ $# -ne 4 ] then echo "指定された引数は$#個です。" 1>&2 echo "実行するには4個の引数が必要です。" 1>&2 exit 1 fi # ditzが実行パス中に有るかチェック which ditz >/dev/null 2>&1 if [ $? -ne 0 ] then echo "ditzがインストールされていません。" 1>&2 exit 1 fi # ditzのバージョンをチェック VERSION=`ditz --version | cut -d ' ' -f 2` if [ $VERSION != "0.5" ] then echo "インストールされているditzのバージョンは{$VERSION}です。" 1>&2 echo "対応しているditzのバージョンは0.5です。" 1>&2 exit 1 fi # 引数を判り易い変数名にしておく TITLE=$1 DESCRIPTION=$2 CREATOR=$3 COMMENT=$4 expect -c " set timeout 5 spawn ditz add expect { default {exit 2} \"Title:\" {send $TITLE; send \"\n\"} } expect { default {exit 3} \"Description (\*):\" {send $DESCRIPTION; send \"\n.\n\"} } expect { default {exit 4} \"Is this a (b)ugfix, a (f)eature, or a (t)ask? \" {send \"t\n\"} } expect { default {exit 5} \"Issue creator (enter for \*):\" {send $CREATOR; send \"\n\"} } expect { default {exit 6} \"Comments (\*):\" {send $COMMENT; send \"\n.\n\"} } expect eof " case "$?" in 0) exit 0 ;; 2) echo "Titleの入力がエラーです。" 1>&2 ; exit 1 ;; 3) echo "Descriptionの入力がエラーです。" 1>&2 ; exit 1 ;; 4) echo "Issue typeの入力がエラーです。" 1>&2 ; exit 1 ;; 5) echo "Issue creatorの入力がエラーです。" 1>&2 ; exit 1 ;; 6) echo "Commentsの入力がエラーです。" 1>&2 ; exit 1 ;; *) echo "不明なエラーです。" 1>&2 ; exit 1 ;; esac exit 0 </pre></div> </div> DitzのGUIフロントエンドを作るにあたって、後調べなければならない事はファイルのアップデートのタイミングを知る為の”FSEvent”を調査する必要がある。 </article> <article> <h1>NSErrorのメモ</h1> Fri, 28 Dec 2012 00:00:00 +0900 <h1>NSErrorのメモ</h1> 箇条書き <ul class="simple"> <li>既存のエラーを探すには</li> </ul> <table border="1" class="colwidths-given docutils" id="id2"> <caption>主なドメインのエラーコードを定義しているファイル</caption> <colgroup> <col width="33%"/> <col width="67%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">ドメイン</th> <th class="head">file path</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>Mach</td> <td>mach/kern_return.h</td> </tr> <tr class="row-odd"><td>POSIX</td> <td>sys/errno.h</td> </tr> <tr class="row-even"><td>Carbon</td> <td>CarbonCore/MacErros.h</td> </tr> <tr class="row-odd"><td>Cocoa(Foundation)</td> <td>Foundation/FoundationErrors.h</td> </tr> <tr class="row-even"><td>Cocoa(AppKit)</td> <td>AppKit/AppKitErrors.h</td> </tr> <tr class="row-odd"><td>Cocoa(CoreData)</td> <td>CoreData/CoreDataErrors.h</td> </tr> </tbody> </table> 上記のfile pathをXCodeの”Open Quickly…”を呼出して打ち込むと、それぞれのファイルが開くので探すと良いらしい。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/openQuick.tiff"></a> </div></blockquote> <ul class="simple"> <li>新しいドメインを作るには</li> </ul> 逆DNS名を使い、他のドメイン名とコンクリフトしないようにする。 エラーコードは、enum等でプログラマの責任で作成する。 独自のNSErrorを作る(<a class="reference external" href="http://stack3ios.hateblo.jp/entry/2012/08/20/103554">http://stack3ios.hateblo.jp/entry/2012/08/20/103554</a>)のようにカテゴリを作ると良い。 <div class="section" id="id1"> <h2>参考文献</h2> <ul class="simple"> <li>独自のNSErrorを作る</li> </ul> <blockquote> <div><a class="reference external" href="http://stack3ios.hateblo.jp/entry/2012/08/20/103554">http://stack3ios.hateblo.jp/entry/2012/08/20/103554</a></div></blockquote> <ul class="simple"> <li>NSError Class Reference</li> </ul> <blockquote> <div><a class="reference external" href="https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSError_Class/Reference/Reference.html">https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSError_Class/Reference/Reference.html</a></div></blockquote> <ul class="simple"> <li>Introduction to Error Handling Programming Guide For Cocoa</li> </ul> <blockquote> <div><a class="reference external" href="https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/ErrorHandlingCocoa/ErrorHandling/ErrorHandling.html">https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/ErrorHandlingCocoa/ErrorHandling/ErrorHandling.html</a></div></blockquote> </div> </article> <article> <h1>ビルド番号に関してのメモ</h1> Thu, 27 Dec 2012 00:00:00 +0900 <h1>ビルド番号に関してのメモ</h1> リンクだけ <div class="section" id="id2"> <h2>参考文献</h2> <ul class="simple"> <li>Xcode 4でビルド番号を自動的に増やす方法</li> </ul> <blockquote> <div><a class="reference external" href="http://www.awaresoft.jp/ios-dev/item/113-xcode-increment-build-num.html">http://www.awaresoft.jp/ios-dev/item/113-xcode-increment-build-num.html</a> <a class="reference external" href="http://stackoverflow.com/questions/6851660/version-vs-build-in-xcode-4">http://stackoverflow.com/questions/6851660/version-vs-build-in-xcode-4</a></div></blockquote> <ul class="simple"> <li>How to Autogenerate App Version Number from GIT</li> </ul> <blockquote> <div><a class="reference external" href="http://jomnius.blogspot.jp/2011/12/how-to-autogenerate-app-version-number.html?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed:+IlessonsIlearned+(iLessons+iLearned)&m=1">http://jomnius.blogspot.jp/2011/12/how-to-autogenerate-app-version-number.html?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed:+IlessonsIlearned+(iLessons+iLearned)&m=1</a></div></blockquote> <ul class="simple"> <li>GIT AND XCODE: A GIT BUILD NUMBER SCRIPT</li> </ul> <blockquote> <div><a class="reference external" href="http://www.cimgf.com/2008/04/13/git-and-xcode-a-git-build-number-script/">http://www.cimgf.com/2008/04/13/git-and-xcode-a-git-build-number-script/</a></div></blockquote> </div> </article> <article> <h1>xcodeでlldbコマンド</h1> Wed, 26 Dec 2012 00:00:00 +0900 <h1>xcodeでlldbコマンド</h1> XCodeのデバッガのコンソールではログの表示だけではなくlldbのコマンドが使える。 以下の３つのコマンドを覚えるだけで便利に使える。 <blockquote> <div><table border="1" class="colwidths-given docutils" id="id1"> <caption>コマンド</caption> <colgroup> <col width="25%"/> <col width="25%"/> <col width="50%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">コマンド</th> <th class="head">引数</th> <th class="head">機能</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>s</td> <td> </td> <td>ステップ実行</td> </tr> <tr class="row-odd"><td>c</td> <td> </td> <td>実行を継続</td> </tr> <tr class="row-even"><td>po</td> <td>式</td> <td>オブジェクト(式)の評価</td> </tr> </tbody> </table> </div></blockquote> poコマンドは多機能で式の評価と言いつつ以下の様に、値の表示、メソッドの実行、変数に代入の機能がある。 <ul class="simple"> <li>id型を見る</li> </ul> <blockquote> <div><div class="highlight-bash notranslate"><div class="highlight"><pre>(lldb) po self.window (NSWindow *) $7 = 0x000000010230d2c0 <NSWindow: 0x10230d2c0> </pre></div> </div> </div></blockquote> <ul class="simple"> <li>メソッドの実行</li> </ul> <blockquote> <div><div class="highlight-bash notranslate"><div class="highlight"><pre>(lldb) po [self openPanel:nil] <no result> (lldb) c </pre></div> </div> </div></blockquote> <ul class="simple"> <li>変数に代入</li> </ul> <blockquote> <div><div class="highlight-bash notranslate"><div class="highlight"><pre>(lldb) po theEvents = nil (SCEvents *) $2 = 0x0000000000000000 <nil> </pre></div> </div> </div></blockquote> </article> <article> <h1>フォルダを読み込む為のCFBundleDocumentTypesの設定</h1> Tue, 25 Dec 2012 00:00:00 +0900 <h1>フォルダを読み込む為のCFBundleDocumentTypesの設定</h1> NSDocumentControllerでfolderを受け付ける為に、info.plistの設定を行った。フォルダータイプを受け付ける為に、CFBundleDocumentTypesの項目に以下の項目を追加した。 <table border="1" class="colwidths-given docutils" id="id2"> <caption>追加項目</caption> <colgroup> <col width="25%"/> <col width="25%"/> <col width="50%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">キー</th> <th class="head">値</th> <th class="head">説明</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>CFBundleTypeExtensions</td> <td>＊</td> <td>任意の拡張子を表す</td> </tr> <tr class="row-odd"><td>CFBundleTypeOSTypes</td> <td>fold</td> <td>OS9でフォルダーを示すOSType</td> </tr> </tbody> </table> しかし、今資料を見たら、これらの設定が”Deprecated”との事。今のところ動作には問題はないようだが、”Deprecated”な物を使うのは気持ちが悪いので変更する。 単純に書くと <ol class="arabic simple"> <li>CFBundleTypeExtensionsとCFBundleTypeOSTypesを削除</li> <li>LSItemContentTypesとLSHandlerRankを追加</li> </ol> で終わり。詳しく書くと、 変更前のinfo.plistは以下 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/before_infoplist.tiff"></a> </div></blockquote> ターゲットのinfoタブでは以下 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/before_infotab.tiff"></a> </div></blockquote> 両方とも同じinfo.plistファイルの内容を反映して表示しています。 変更後のinfo.plistは以下 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/after_infoplist.tiff"></a> </div></blockquote> ターゲットのinfoタブでは以下 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/after_infotab.tiff"></a> </div></blockquote> CFBundleTypeExtensionsとCFBundleTypeOSTypesを削除し、LSItemContentTypesとLSHandlerRankを追加した。 <table border="1" class="colwidths-given docutils" id="id3"> <caption>追加項目</caption> <colgroup> <col width="25%"/> <col width="25%"/> <col width="50%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">キー</th> <th class="head">値</th> <th class="head">説明</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>LSItemContentTypes</td> <td>public.folder</td> <td>フォルダーを表すUTI</td> </tr> <tr class="row-odd"><td>LSHandlerRank</td> <td>none</td> <td> </td> </tr> </tbody> </table> 扱うファイルがLSHandlerRankの値は、扱うファイルがフォルダーの為にnoneとした。 <div class="section" id="id1"> <h2>参考文献</h2> <dl class="docutils"> <dt>iOSアプリケーションを特定のファイル形式に対応させる方法について :</dt> <dd><a class="reference external" href="http://safx-dev.blogspot.jp/2010/11/ios_21.html">http://safx-dev.blogspot.jp/2010/11/ios_21.html</a></dd> <dt>UTI一覧 : System-Declared Uniform Type Identifiers</dt> <dd><a class="reference external" href="http://developer.apple.com/library/mac/#documentation/Miscellaneous/Reference/UTIRef/Introduction/Introduction.html">http://developer.apple.com/library/mac/#documentation/Miscellaneous/Reference/UTIRef/Introduction/Introduction.html</a></dd> <dt>Info.plist用のキー一覧 : information Property list key Refarence</dt> <dd><a class="reference external" href="http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html">http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html</a></dd> </dl> </div> </article> <article> <h1>man ditzが出ない</h1> Mon, 24 Dec 2012 00:00:00 +0900 <h1>man ditzが出ない</h1> 私の環境では以下のようにして出せる。 こんな所にもmanのパスを通す物なのだろうか？それともrubyのgemと言う物に何か設定をしなければイケナイのかもしれない。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ man /Library/Ruby/Gems/1.8/gems/ditz-0.5/man/ditz.1 </pre></div> </div> </article> <article> <h1>CocoaでYAML</h1> Sun, 23 Dec 2012 00:00:00 +0900 <h1><a class="toc-backref" href="#id5">CocoaでYAML</a></h1> <div class="contents topic" id="contents"> Contents <ul class="simple"> <li><a class="reference internal" href="https://www.mindto01s.com/2012/12/23/yaml_in_cocoa.html#cocoayaml" id="id5">CocoaでYAML</a><ul> <li><a class="reference internal" href="https://www.mindto01s.com/2012/12/23/yaml_in_cocoa.html#id1" id="id6">はじめに</a></li> <li><a class="reference internal" href="https://www.mindto01s.com/2012/12/23/yaml_in_cocoa.html#id2" id="id7">開発環境</a></li> <li><a class="reference internal" href="https://www.mindto01s.com/2012/12/23/yaml_in_cocoa.html#id3" id="id8">ビルド方法</a></li> <li><a class="reference internal" href="https://www.mindto01s.com/2012/12/23/yaml_in_cocoa.html#id4" id="id9">参考文献</a></li> </ul> </li> </ul> </div> <div class="section" id="id1"> <h2><a class="toc-backref" href="#id6">はじめに</a></h2> MacOSX上のCocoaでYAMLを読み込む必要が出て来た。そこでgoogle先生に伺った所、何種類かライブラリが出て来た。トップ表示されていたSyckライブラリを使う事にした。 SyckにはCocoa用ラッパーのフレームワークが入っており、コレをビルド出来ればCocoaから簡単に使う事が出来る。 この文書はその時のビルド方法のメモです。なお、iOS上での動作確認はしてません。 </div> <div class="section" id="id2"> <h2><a class="toc-backref" href="#id7">開発環境</a></h2> 開発環境は以下の通りです <table class="docutils field-list" frame="void" rules="none"> <col class="field-name"/> <col class="field-body"/> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">MacOSX:</th><td class="field-body">10.8.2</td> </tr> <tr class="field-even field"><th class="field-name">XCode:</th><td class="field-body">4.5.2</td> </tr> <tr class="field-odd field"><th class="field-name">Syck:</th><td class="field-body">0.7(commit 2656dcc9e879a26e0d7c36ae45f22150d2692ad0)</td> </tr> </tbody> </table> </div> <div class="section" id="id3"> <h2><a class="toc-backref" href="#id8">ビルド方法</a></h2> “<a class="reference external" href="https://github.com/indeyets/syck">https://github.com/indeyets/syck</a>”から圧縮ファイルをダウンロード解凍する そのままbootstrapファイルを実行するとエラーになるので一部修正する。理由は”libtoolize”が見つからないため。 私の環境では”/opt/local/bin/glibtoolize”にMacPortsで入れていたのでlibtoolizeの代わりにglibtoolizeを使うよう以下のように変更した。 <div class="highlight-bash notranslate"><div class="highlight"><pre>#! /bin/sh set -x aclocal autoheader autoconf # libtoolizeをglibtoolizeに変更 glibtoolize automake --foreign --add-missing --copy </pre></div> </div> この変更を行えばlibsyck.aの生成まで以下のコマンドで行えます。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ cd 解凍後のディレクトリへのパス $ ./bootstrap $ ./configure $ make </pre></div> </div> その後、./ext/cocoaにあるYAML.xcodeprojの変更を行う。修正箇所は３カ所。 <ol class="arabic simple"> <li>“YAML_Prefix.pch”をResourcesフォルダーにコピーしないようにする</li> </ol> <blockquote> <div>おそらく何らかの操作ミスで、コピーする項目に入ってしまったのだろう。以下の図の様にコピー対象から外す。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/yaml-PCH-before.tiff"></a> 外すとこうなります。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/yaml-PCH-after.tiff"></a> </div></blockquote> <ol class="arabic simple" start="2"> <li>Info.plsitの”Bundle ID”を修正する。</li> </ol> <blockquote> <div>“Bundle ID”がプロジェクト作成時の初期設定のままの”com.apple.yourcocoaframework”なので変更する。ここで、IDは制作者に敬意を払い、”net.thimbleby.will.yaml.in.cocoa”とする。 元の設定が以下のようになっているのを <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/yaml-InfoPlist-before.tiff"></a> この様に変更する。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/yaml-InfoPlist-after.tiff"></a> </div></blockquote> <ol class="arabic simple" start="3"> <li>GSNSDataExtensions.mで配列の容量が足らない気がするので追加</li> </ol> <blockquote> <div>これは非常に簡単。 <table class="docutils field-list" frame="void" rules="none"> <col class="field-name"/> <col class="field-body"/> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">file:</th><td class="field-body">ext/cocoa/src/Base64 NSData code/GSNSDataExtensions.m</td> </tr> <tr class="field-even field"><th class="field-name">line:</th><td class="field-body">200</td> </tr> </tbody> </table> の配列outbufの長さをを3から4に変えただけ。 <div class="highlight-c notranslate"><div class="highlight"><pre>unsigned char inbuf [4], outbuf [3]; </pre></div> </div> を <div class="highlight-c notranslate"><div class="highlight"><pre>unsigned char inbuf [4], outbuf [4]; </pre></div> </div> に変えた。 </div></blockquote> アドレスを他にも、32bitから64bitへ移行したので、NSLogやprintfの%dを%ldに変える必要があるらしいが、詳しい事が判らないのでパス。 最後にビルドする。ここではDeploymentビルドを手軽にコピーしたいのでxcodebuild経由でビルドしています。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ xcodebuild -configuration Deployment -sdk macosx10.8 </pre></div> </div> これで”ext/cocoa/build/Deployment”にYAML.frameworkが出来ます。 <a class="reference internal image-reference" href="https://www.mindto01s.com/_images/yaml-framework.tiff"></a> </div> <div class="section" id="id4"> <h2><a class="toc-backref" href="#id9">参考文献</a></h2> Cocoa Wapperを書いた人のサイト <a class="reference external" href="http://will.thimbleby.net/yaml-in-cocoa/">http://will.thimbleby.net/yaml-in-cocoa/</a> 多分Syckの公式サイト <a class="reference external" href="https://github.com/indeyets/syck">https://github.com/indeyets/syck</a> </div> </article> <article> <h1>ditzのreadmeを読む(後半)</h1> Sat, 22 Dec 2012 00:00:00 +0900 <h1>ditzのreadmeを読む(後半)</h1> 後半部分です。力尽きた。 <div class="section" id="ditz"> <h2>DITZのデータモデル</h2> デフォルトの設定で、Ditzはオープンソース開発のために必要な最低限の機能セットを含んでいます。 経過時間、優先度、開発者へのタスクの割当、期日等の機能は意図的にプラグインシステムに任せるようにしています。 Ditzのプロジェクトは、issues, releases, componentsの３つで構成されています。 <dl class="docutils"> <dt>Issues:</dt> <dd>issuesはBTSの基本的な要素です。Ditzのissueは機能(feature), バグ(bug), タスク(task)のいずれかです。しかし、現在の所、このissueの種類は、表示以外には影響しません。 それぞれのissuesは、1つのコンポーネントに属しており、0個か1個のリリースの一部になっています。 それぞれのissuesは、データエクスポートに使えるランダムな40桁の16進数のIDを持っています。 IDは、一意である事が保証されています。IDは通常ユーザーは目にする事はありません。 issueは人が読める形式の名前を持っています。でもその名前は一意でないしデータエクスポートにも使えません。全てのditzコマンドはissue IDの他にも、issueの名前を使えます。 issue名は特定の状況で変更される事が有ります。例えば、”ditz drop”コマンドの後に変更されます。 issue名は、コメント、タイトル、内容等の中に書く事が出来ます。ditzはissue名が変更された時に自動的にそれらを書き換えます。 </dd> <dt>Components:</dt> <dd>プロジェクトには常に総称的なcomponentが一つあります。そのcomponentの名前はプロジェクト名と同じになってます。 最も単純な場合は、componentはこの総称的なcomponentが唯一の物になります。そして、ユーザーがcomponentにissueを割り当てる問題に煩わされることはありません。 componentは単純にissuesを整理する為の方法です。実際には何の機能も有りません。 issues名は、割当てられるcomponent名から派生して名付けられます。 </dd> <dt>Releases:</dt> <dd>releaseはissueの為の主要なグルーピング機構です。 “ditz status”や”ditz todo”のような状態確認コマンドは常に、releaseによってグルーピングされたissuesに作用します。 releaseが100%完了した時に、そのreleaseはリリースされたとマークを付ける事が出来ます。そして、そのreleaseに属していたissueは停止したと”ditz status”や”ditz todo”のメッセージに表示されます。 </dd> </dl> </div> <div class="section" id="id1"> <h2>もっと知りたい時は</h2> <ul class="simple"> <li>helpを見るか</li> </ul> <div class="highlight-bash notranslate"><div class="highlight"><pre>$ ditz help </pre></div> </div> <ul class="simple"> <li>ソースコードを見てください</li> </ul> <div class="highlight-bash notranslate"><div class="highlight"><pre>$ find $DITZ_INSTALL_DIR -type f | xargs cat </pre></div> </div> </div> <div class="section" id="id2"> <h2>必要条件</h2> <ul class="simple"> <li>trollop >= 1.8.2, if running via RubyGems.</li> </ul> </div> <div class="section" id="id3"> <h2>インストールするには</h2> “<a class="reference external" href="http://rubyforge.org/projects/ditz/">http://rubyforge.org/projects/ditz/</a>”から圧縮ファイルをダウンロードするか、 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ gem install ditz </pre></div> </div> と打ち込んでください。 </div> <div class="section" id="id4"> <h2>ライセンス</h2> Copyright (c) 2008 William Morgan. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. </div> </article> <article> <h1>ditzのreadmeを読む(前半)</h1> Fri, 21 Dec 2012 00:00:00 +0900 <h1>ditzのreadmeを読む(前半)</h1> 正直言って、helpだけではよくわからないので、google先生にお願いしてREADME.txtを翻訳してもらう。おかしな所はほんのり修正。 まずは前半部分だけ。 <div class="section" id="ditz"> <h2>ditz</h2> by William Morgan <wmorgan-ditz at the masanjin dot nets> <a class="reference external" href="http://ditz.rubyforge.org">http://ditz.rubyforge.org</a> </div> <div class="section" id="id1"> <h2>説明</h2> Ditzはシンプルで軽量な分散型バグトラッカーです。 git, darcs, Mercurial, Bazaarのような分散型バージョン管理システムで動作するように設計されています。 また、SVNのような集中型システムで使用することができます。 DitzはYAML形式のファイルを使用して、ディスク上に問題データベースディレクトリを維持/作成します。このディレクトリは、プロジェクトのソースコードと一緒にバージョン管理下におく事が出来ます。 Ditzは問題データベースファイルを作成/更新するためのシンプルなコマンドラインベースのインターフェイスを持っています。また、ブラウザで現状を確認出来るように、静的HTMLの生成機能を持っています。(デモはDitzページを参照してください） Ditzにはモデルフィールドにコマンドを追加し、出力を変更する堅牢なプラグインシステムが含まれています。バンドルされているプラグインのマニュアルについてはPLUGINS.txtを参照してください。 現状ではDitzは、集中型システム用のバグ申請を行う方法を持っていません。 </div> <div class="section" id="id2"> <h2>使い方</h2> Ditzを使用するには、いくつかの異なる方法があります。 <ol class="arabic simple"> <li>ソースコードと同じ場所に問題データベースを設置する。issueはコミットの一部として含まれています。他の開発者からの変更による競合は、通常の方法で解決しマージします。</li> <li>ソースコードとは別のブランチに問題データベースを設置する。issueの更新をVCSによって管理することができますが、コードに直接結びつけられてはいません。</li> <li>VCSで問題データベースを管理しない。</li> </ol> これらのオプションはすべてサポートされています。どの方法を選択するかは、あなたのワークフローに依存します。 <ul class="simple"> <li><dl class="first docutils"> <dt>オプション＃1</dt> <dd>おそらく非同期分散開発に最も適しています。個々の開発者が面倒を最小限に抑えて問題の状態を変更することができます。</dd> </dl> </li> <li><dl class="first docutils"> <dt>オプション＃2</dt> <dd>issueの追加/更新とコードの変更は、それぞれ独立してVCSにコミット出来ます。同期開発に最も適しています。(git同期プラグインを参照してください)</dd> </dl> </li> <li><dl class="first docutils"> <dt>オプション＃3</dt> <dd>集中型Webインターフェイスと同様に、いくつかの他の配布方式でのみ有用です。</dd> </dl> </li> </ul> </div> <div class="section" id="id3"> <h2>コマンドライン要約</h2> <div class="section" id="bugs-yaml"> <h3>プロジェクトをセットアップして、bugs.yamlファイルを作る</h3> <ol class="arabic simple"> <li>ditz init</li> <li>ditz add-release</li> </ol> </div> <div class="section" id="issue"> <h3>issueの追加</h3> <ol class="arabic simple" start="3"> <li>ditz add</li> </ol> </div> <div class="section" id="id4"> <h3>現状確認</h3> <ol class="arabic simple" start="4"> <li>ditz status</li> <li>ditz todo (or simply “ditz”)</li> </ol> </div> <div class="section" id="id5"> <h3>お仕事をする</h3> <ol class="arabic simple" start="6"> <li>コードを書く</li> <li>ditz close <issue-id></li> <li>コミットする</li> <li>3に戻る</li> </ol> </div> <div class="section" id="id6"> <h3>ひと仕事終ったら</h3> <ol class="arabic simple" start="10"> <li>ditz release <release-name></li> </ol> </div> </div> </article> <article> <h1>ditzコマンド補完</h1> Thu, 20 Dec 2012 00:00:00 +0900 <h1>ditzコマンド補完</h1> ditzのMLを読んでいると、ditzコマンド補完のbashスクリプトが有るらしい事が判った。 しかしインストール場所が判らなかったので、findすると以下の場所にインストールされていた。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ find / -name "ditz*" . . . /Library/Ruby/Gems/1.8/cache/ditz-0.5.gem /Library/Ruby/Gems/1.8/doc/ditz-0.5 /Library/Ruby/Gems/1.8/doc/ditz-0.5/rdoc/files/lib/ditz_rb.html /Library/Ruby/Gems/1.8/gems/ditz-0.5 /Library/Ruby/Gems/1.8/gems/ditz-0.5/bin/ditz /Library/Ruby/Gems/1.8/gems/ditz-0.5/contrib/completion/ditz.bash /Library/Ruby/Gems/1.8/gems/ditz-0.5/lib/ditz.rb /Library/Ruby/Gems/1.8/gems/ditz-0.5/man/ditz.1 /Library/Ruby/Gems/1.8/specifications/ditz-0.5.gemspec . . . </pre></div> </div> この中の”ditz.bash”が補完スクリプトなので、”~/.bash_profile”に <div class="highlight-bash notranslate"><div class="highlight"><pre>source /Library/Ruby/Gems/1.8/gems/ditz-0.5/contrib/completion/ditz.bash </pre></div> </div> を追加すると補完が効くようになる。正直ditzは補完が無いと使いにくい。 </article> <article> <h1>特定のドットファイルがあるフォルダーを選択するには</h1> Wed, 19 Dec 2012 00:00:00 +0900 <h1>特定のドットファイルがあるフォルダーを選択するには</h1> <div class="section" id="id2"> <h2>はじめに</h2> コマンドラインツールには、ファイル名の先頭に”.”がついたファイルを作成する物がある。所謂ドットファイルだ。 このドットファイルは、Finder上では不可視ファイルになっていて通常は見る事は出来ない。 Cocoaでこのファイルを選択するには、通常 <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>- [NSOpenPanel setShowsHiddenFiles:(BOOL)flag]; </pre></div> </div> </div></blockquote> にYESを渡して使用する。 しかしこの方法では、全ての不可視ファイルが Open Panel に表示されてしまう。不可視ファイルは想像以上に多いので、ユーザーは混乱するだろう。 <blockquote> <div><a class="reference internal image-reference" href="https://www.mindto01s.com/_images/selecting_dot_File_Folder_1.tiff"></a> </div></blockquote> こんな画面は誰も見たくないでしょう？ 解決策として、 <ol class="arabic simple"> <li>混乱を避ける為に不可視ファイルは表示させない</li> <li>特定のドットファイルが存在するフォルダーだけを読込み可能にする</li> </ol> 以上の２点を満たす方法を考えてみた。 </div> <div class="section" id="id3"> <h2>開発環境</h2> 開発環境は以下の通りです <table class="docutils field-list" frame="void" rules="none"> <col class="field-name"/> <col class="field-body"/> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">MacOSX:</th><td class="field-body">10.8.2</td> </tr> <tr class="field-even field"><th class="field-name">XCode:</th><td class="field-body">4.5.2</td> </tr> </tbody> </table> </div> <div class="section" id="id4"> <h2>基本方針</h2> NSOpnePanelのdelegateを使う。 <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>- [NSOpenSavePanelDelegate panel:(id)sender didChangeToDirectoryURL:(NSURL *)url]; </pre></div> </div> </div></blockquote> このdelegatメソッドは、OpenPaneで注目中のディレクトリが変更される毎に呼出される。呼出された時に、ディレクトリを走査し、目的のドットファイルが有るか確認する。 目的のドットファイルが存在した場合だけ <blockquote> <div><div class="highlight-objc notranslate"><div class="highlight"><pre>- [NSOpenPanel setCanChooseDirectories:(BOOL)flag]; </pre></div> </div> </div></blockquote> にYESに設定してフォルダーを読込み可能にする。 </div> <div class="section" id="id5"> <h2>実装</h2> OpenPanelを表示してドットファイル”.ditz-config”が存在するフォルダーを読込み可能にするコードを示す。ここで、”.ditz-config”はditzの設定ファイル名なので、各自の目的に合わせて変更してください。 <div class="highlight-objc notranslate"><div class="highlight"><pre>- (IBAction)openPanel:(id)sender; { NSOpenPanel* theOpenPanel = [NSOpenPanel openPanel]; [theOpenPanel setAllowsMultipleSelection:NO]; [theOpenPanel setCanChooseFiles:NO]; [theOpenPanel setDelegate:self]; [theOpenPanel beginWithCompletionHandler:^(NSInteger result) { if (result == NSFileHandlingPanelOKButton) { NSURL* thePath = [[theOpenPanel URLs] objectAtIndex:0]; NSLog(@" thePath: %@\n", thePath); } } ]; } - (void)panel:(id)inSender didChangeToDirectoryURL:(NSURL *)inURL { NSOpenPanel* theOpenPanel = inSender; NSFileManager* theFileManager = [NSFileManager defaultManager]; NSString* theFilePath = [inURL path]; NSArray* theFileLists; BOOL theFlag; theFileLists = [theFileManager contentsOfDirectoryAtPath:theFilePath error:nil]; theFlag = [theFileLists containsObject:@".ditz-config"]; [theOpenPanel setCanChooseDirectories:theFlag]; } </pre></div> </div> 実装はコレだけです。 </div> </article> <article> <h1>ditzのサブコマンド</h1> Tue, 18 Dec 2012 00:00:00 +0900 <h1>ditzのサブコマンド</h1> ditzの調査。 ditzに続くサブコマンドの説明は、”ditz help”で表示される。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ditz help Ditz commands: add: Add an issue add-component: Add a component add-reference: Add a reference to an issue add-release: Add a release archive: Archive a release assign: Assign an issue to a release changelog: Generate a changelog for a release close: Close an issue comment: Comment on an issue drop: Drop an issue edit: Edit an issue grep: Show issues matching a string or regular expression help: List all registered commands html: Generate html status pages init: Initialize the issue database for a new project log: Show recent activity reconfigure: Rerun configuration script release: Release a release releases: Show releases set-component: Set an issues component shortlog: Show recent activity (short form) show: Describe a single issue start: Start work on an issue status: Show project status stop: Stop work on an issue todo: Generate todo list unassign: Unassign an issue from any releases validate: Validate project status Use "ditz help <command>" for details. </pre></div> </div> ここでサブコマンドのhelpは”ditz help COMMAND”で表示されると書いてあるけど、あまり詳しくない。 表にまとめるとこんな感じ。 <table border="1" class="colwidths-given docutils" id="id1"> <caption>サブコマンド一覧</caption> <colgroup> <col width="20%"/> <col width="20%"/> <col width="60%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">サブコマンド</th> <th class="head">引数</th> <th class="head">機能</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>add</td> <td> </td> <td>issueの追加</td> </tr> <tr class="row-odd"><td>add-component</td> <td> </td> <td>componentの追加</td> </tr> <tr class="row-even"><td>add-reference</td> <td><issue></td> <td>issueに他のissueへの参照を追加</td> </tr> <tr class="row-odd"><td>add-release</td> <td>[name]</td> <td>releaseを追加</td> </tr> <tr class="row-even"><td>archive</td> <td><release> [dir]</td> <td>releaseをアーカイブ</td> </tr> <tr class="row-odd"><td>assign</td> <td><issue> [release]</td> <td>issueをreleaseに割り当てる</td> </tr> <tr class="row-even"><td>changelog</td> <td><release></td> <td>releaseかchangelogを生成</td> </tr> <tr class="row-odd"><td>close</td> <td><open_issue></td> <td>issueを閉じる</td> </tr> <tr class="row-even"><td>comment</td> <td><issue></td> <td>issueにコメントを追記する</td> </tr> <tr class="row-odd"><td>drop</td> <td><issue></td> <td>issueを削除</td> </tr> <tr class="row-even"><td>edit</td> <td><issue></td> <td>issueを編集</td> </tr> <tr class="row-odd"><td>grep</td> <td><string></td> <td>文字列か正規表現に一致したissueを表示する</td> </tr> <tr class="row-even"><td>help</td> <td>[command]</td> <td>サブコマンドのhelpを表示する</td> </tr> <tr class="row-odd"><td>html</td> <td>[dir]</td> <td>htmlページを生成</td> </tr> <tr class="row-even"><td>init</td> <td> </td> <td>新規プロジェクトを作成する</td> </tr> <tr class="row-odd"><td>log</td> <td> </td> <td>活動履歴を表示する</td> </tr> <tr class="row-even"><td>reconfigure</td> <td> </td> <td>設定を再設定する</td> </tr> <tr class="row-odd"><td>release</td> <td><unreleased_release></td> <td>releaseを公開する</td> </tr> <tr class="row-even"><td>releases</td> <td> </td> <td>リリースのリストを表示する</td> </tr> <tr class="row-odd"><td>set-component</td> <td><issue> [component]</td> <td>issuesをcomponentに登録する</td> </tr> <tr class="row-even"><td>shortlog</td> <td> </td> <td>短い形式で活動履歴を表示する</td> </tr> <tr class="row-odd"><td>show</td> <td><issue></td> <td>issueの詳細を表示する</td> </tr> <tr class="row-even"><td>start</td> <td><unstarted_issue></td> <td>issueの作業を開始する</td> </tr> <tr class="row-odd"><td>status</td> <td>[release]</td> <td>プロジェクトの状態を表示する</td> </tr> <tr class="row-even"><td>stop</td> <td><started_issue></td> <td>issueの作業を停止する</td> </tr> <tr class="row-odd"><td>todo</td> <td>[release]</td> <td>ToDoリストを表示する</td> </tr> <tr class="row-even"><td>unassign</td> <td><assigned_issue></td> <td>issueをreleaseの登録から外す</td> </tr> <tr class="row-odd"><td>validate</td> <td> </td> <td>プロジェクトのstatusを検証する</td> </tr> </tbody> </table> 用語の整理や関係を書かないと判りにくいな。 </article> <article> <h1>ditzのオプション</h1> Mon, 17 Dec 2012 00:00:00 +0900 <h1>ditzのオプション</h1> ditzの調査。 まずは”ditz –help”をGoogle先生に読んでもらう。 <div class="highlight-bash notranslate"><div class="highlight"><pre>$ditz --help ditz 0.5 Options: --issue-dir, -i <s>: Issue database dir (default: bugs) --config-file, -c <s>: Configuration file (default: ./.ditz-config) --plugins-file, -p <s>: Plugins file (default: ./.ditz-plugins) --verbose, -v: Verbose output --list-hooks, -l: List all hooks and descriptions, and quit. --version, -e: Print version and exit --help, -h: Show this message </pre></div> </div> Google先生にお伺いをして、多少手直しすると、こんな感じ。 <table border="1" class="colwidths-given docutils" id="id1"> <caption>オプションとその機能</caption> <colgroup> <col width="25%"/> <col width="75%"/> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">オプション</th> <th class="head">機能</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>–issue-dir, -i <s></td> <td>Issue databaseディレクトリの指定 (デフォルト値: bugs)</td> </tr> <tr class="row-odd"><td>–config-file, -c <s></td> <td>設定ファイルの指定 (デフォルト値: ./.ditz-config)</td> </tr> <tr class="row-even"><td>–plugins-file, -p <s></td> <td>プラグインディレクトリの指定 (デフォルト値: ./.ditz-plugins)</td> </tr> <tr class="row-odd"><td>–verbose, -v</td> <td>Verbose(冗長)出力モードにする。</td> </tr> <tr class="row-even"><td>–list-hooks, -l</td> <td>全てのHookとその説明を出力する。</td> </tr> <tr class="row-odd"><td>–version, -e</td> <td>バージョン番号を表示する。</td> </tr> <tr class="row-even"><td>–help, -h</td> <td>このヘルプメッセージを表示する。</td> </tr> </tbody> </table> これだけだと、全く意味不明だな。 </article> <article> <h1>GitでVCSが分散出来るならば、BTSも分散したい</h1> Wed, 21 Nov 2012 00:00:00 +0900 <h1>GitでVCSが分散出来るならば、BTSも分散したい</h1> Ditzと呼ばれる分散型BTSソフトウェアがある。 インストールして少し使ってみたが、まだ使い方がよくわからない。 </article> </main></body></html>

文字	意味
“O”	セルが生存状態
“.”	セルが非生存状態
“r”	次の行、または終了マーカー

設定項目	説明
Project name	生成されるApple help bookのファイル名になります。
Project language	ローカライズに使用されます。日本語ならばjaを使用します。
Create Windows command file?	信仰心が試される箇所です。最後まで気を抜かずに、必ずnにしましょう。

キー	値	説明
CFBundleHelpBookName	com.mindto01s.HalloWorld.help	conf.pyで設定したapplehelp_bundle_idの値
CFBundleHelpBookFolder	HalloWorld.help	AppleHelpBookのフォルダ名

MindTo01s

キーボードショートカットのデバッグ用コード

キーボードショートカットのデバッグ用コード

非公開APIを使わない、Migemoみたいな逐次検索

非公開APIを使わない、Migemoみたいな逐次検索

TSMが変換候補を表示しているか否かの判定

TSMが変換候補を表示しているか否かの判定

ローマ字かな変換表

ローマ字かな変換表

NSTextViewにCommand Paletteをつける

NSTextViewにCommand Paletteをつける

午前1時、室温は29度。エアコンの調子がおかしい。

午前1時、室温は29度。エアコンの調子がおかしい。

NSUserDefaultsControllerでbinding出来るデータ構造についてのメモ

NSUserDefaultsControllerでbinding出来るデータ構造についてのメモ

室温が30度を超える。

室温が30度を超える。

Symbol font を使う

Symbol font を使う

NSUserDefaultsControllerでUndo/Redo

NSUserDefaultsControllerでUndo/Redo

DocumentとDefault

DocumentとDefault

CoreDataとDrag&Drop

CoreDataとDrag&Drop

Tab機能の拡張を諦める。

Tab機能の拡張を諦める。

Servicesメニューの実装

Servicesメニューの実装

ヒレガス本 21章 課題1 swift版

ヒレガス本 21章 課題1 swift版

ヒレガス本 21章 課題1

ヒレガス本 21章 課題1

Cellを使ったControllサブクラス化

Cellを使ったControllサブクラス化

CocoaでPACパターン

CocoaでPACパターン

FontWellの再実装

FontWellの再実装

IB上からのbindingの設定方法

NSViewControllerのサンプルコードその2

NSViewControllerのサンプルコードその2

NSViewControllerのサンプルコードその1

NSViewControllerのサンプルコードその1

内側に影が付いている ScrollView

内側に影が付いている ScrollView

長押しするPopupmenuのボタン

長押しするPopupmenuのボタン

Responder chainの表示

Responder chainの表示

Cocoaで Box Shadow

Cocoaで Box Shadow

NSPasteboardの動作を調べるために小さなアプリを作ってみた(2)

NSPasteboardの動作を調べるために小さなアプリを作ってみた(2)

NSPasteboardの動作を調べるために小さなアプリを作ってみた

NSPasteboardの動作を調べるために小さなアプリを作ってみた

結論

TabUIの実験

TabUIの実験

ライフゲームその5 swiftで書き直した

ライフゲームその5 swiftで書き直した

ライフゲームその4 swiftで書き直した

ライフゲームその4 swiftで書き直した

NSMenuの中にNSViewを入れる

NSMenuの中にNSViewを入れる

落穂拾い 2018/08/10

落穂拾い 2018/08/10

News - Apple Developer

スラド: アップル

VirtualBoxへのMojaveのインストール

VirtualBoxへのMojaveのインストール

概要

インストール手順

準備

VMの作成

メディアの初期化

インストール開始

ファイルのコピー

Guest/HostもmacなVirtualBoxのストレージの拡張方法

Guest/HostもmacなVirtualBoxのストレージの拡張方法

ヒレガス本 21章課題1 swift版

ヒレガス本 21章課題1 swift版

ヒレガス本 21章課題1

ヒレガス本 21章課題1