ライブラリやフレームワークを早く使いこなす方法

ライブラリやフレームワークを早く使いこなす方法

ライブラリやフレームワークを早く使いこなす方法

このブログでは自分なりに得た個人開発についての方法論をいろいろと紹介している。全工程を自分でやらなければならない個人開発は、自身の能力を底上げするのに最高の方法でもある。その過程で、アプリをよりよいものにするために新しいライブラリやフレームワークの導入を検討する事も多々あるだろう。

コードを書く時間というのは実は意外に短くて、基本的に作業時間の40%以上は勉強や調べ物に費やされる。以前、WakaTimeというコーディング時間を計測するサービスで計ってみたら、週に20時間程度しかやってなかった。となると、ドキュメントを読む時間やそれを理解する時間は、場合によってはボトルネックになりうるという事だ。言い換えると、ライブラリやフレームワークの使い方を素早く把握できれば、仕事の速さが大きく向上する。

本稿では、技術の使い方を素早く把握して手早く自身のプロダクトに適用するための考え方をシェアしたい。

まず技術を学ぶことは目的ではない事に注意する。アプリを作ることが目的なので、使いたい技術の全容を把握する必要は全くない。超初心者はともかく、本を買ったりして1ページ1ページありがたく目を通すなど時間の無駄。本を読んでいる自分に酔っている事に気づいた方がいい。基本を把握したら、あとは分からないところを掻い摘んで調べればいい。

知らないことを恐れる必要はない。エラーにぶつかることも恐れる必要はない。自分は今もしかしたら非効率だったり間違ったやりかたで作っているかもしれないという不安を受け入れる。ハードウェアだと間違えば壊れてしまうリスクがあるけど、ソフトウェアは何度でもリセットできる。

何かと教科書のようにまとまった情報を求める人がいる。確かに部分的な知識で車を運転すれば死の危険があるけど、ライブラリを誤って使って死ぬことはまず無い。だから「なんだこのAPI?叩いてみよう」ぐらいの気軽さでいい。

一般的に広く使われるフレームワークやライブラリは、その使い方に綺麗な一貫性がある。なぜなら、不規則で全部まる覚えしなければならないような技術は使いづらくて人々に受け入れられないから。

すごく単純な例を挙げると、PHPにstrpos(A, B) という関数がある。この関数は、 A で指定した文字列の中から B を探して、何文字目に見つかったかと返すもの。添字はゼロ番目から始まる。つまり、3文字目に見つかれば2が返る。さて、もしBが見つからなかったら何が返る?

答えはFALSE。これは覚えるしか無い。じゃあ次、 array_search(A, B) という関数があって、これは B の配列から A を探して、何番目の要素に見つかったか返す。さて、要素が見つからなかった時の戻り値は NULL か、それとも -1か?

いやいや、答えはFALSE だ。NULL か -1 かという選択肢に違和感を覚えた人は要領がいい。もし素直にうーんと悩んじゃった人は、教科書的に丸覚えしようとしている。strpos も array_search も中身を探すという内容の関数なんだから、見つからなかった時の戻り値がもしそれぞれ違ったら設計に一貫性が欠ける事になる。だからおかしい、という考え方が重要。

PHPには他にも strrpos という似た関数がある。見つからなかった時の戻り値は…もうドキュメントを読まなくてもお分かりだろう。

いい技術は名前にもしっかり一貫性がある。だから全部覚えなくてもなんとなく「こういうメソッドを探してるんだけど、こんな名前でありそうだなー。ほらあった!」と推測できることが大事。

例えばElectronのBrowserWindowというクラスには沢山のメソッドが用意されているけど、命名規則がしっかりしていてとても探しやすい。ウインドウを最大化する maximize() というメソッドに対して、最大化されているかどうかを調べる isMaximized() というメソッドがある。もうお分かりのように、 minimize() と isMinimized() も同じく用意されている。

まぁ最大化と最小化も出来るんだからフルスクリーンもこのクラスで出来そうだよね、ほら setFullScreen() と isFullScreen() があった。と、こういう感じで推測していく。もしフルスクリーン処理だけ別のクラスに用意されていたら、設計がおかしいか何か別の事情があると考える。

このように、相手の気持ちを慮れる人の方が人付き合いが上手いように、設計者の気持ちを想像できる人の方が技術と上手く付き合える。

上記で述べたような法則は、典型的な良いソフトウェアの特徴。だから自分がコードを書くときも同じようにルールを意識すると、後々助かる事が沢山ある。なぜなら、一ヶ月後の自分は別人だから。

時間が経って綺麗サッパリ忘れた自分が過去の自分のコードを読み取る時、簡潔なルールに沿って書かれていれば、「あの処理はあそこにあるっぽい」とすぐに把握して作業を再開できる。サーバを書いて、クライアントを書いて、一ヶ月後にまたサーバを書く、という事はざらにある。その場しのぎのコードは身を滅ぼす。継続的に個人開発していくためには、自分の過去のコードをすぐに把握できる事がとても大事。

この記事があなたの個人開発の手助けになれば嬉しい。

使ってね!!

Read more

Inkdrop v6 Canary版リリースしました — 新Markdownエディタやその他新機能盛り沢山

Inkdrop v6 Canary版リリースしました — 新Markdownエディタやその他新機能盛り沢山

Inkdrop v6.0.0 Canary版リリースしました — 新Markdownエディタやその他新機能盛り沢山 こんにちはTAKUYAです。 v6.0.0 の最初の Canary バージョンをリリースしました 😆✨ v6では、アプリのコア機能の改善がたくさん盛り込まれています! * リリースノート(英語): https://forum.inkdrop.app/t/inkdrop-desktop-v6-0-0-canary-1/5339 CodeMirror 6 ベースの新しいエディタ フローティングツールバー v5ではツールバーがエディタの上部に固定されており、使っていないときもスペースを占有していました。 v6では、テキストを選択したときだけ表示されるフローティングツールバーに変わりました。 GitHub Alerts 構文のサポート Alerts の構文が正しい色と左ボーダーでハイライトされるようになりました。 ネストされたアラートや引用にも対応しています。 また、アラートタイプの入力を支援する補完機能も追加されました。 スラッシュコマンド 空行で /

By Takuya Matsuyama
AIのお陰で最近辛かった個人開発がまた楽しくなった

AIのお陰で最近辛かった個人開発がまた楽しくなった

AIのお陰で最近辛かった個人開発がまた楽しくなった こんにちは、TAKUYAです。日本語ではお久しぶりです。僕はInkdropというプレーンテキストのMarkdownノートアプリを、デスクトップとモバイル向けにマルチプラットフォームで提供するSaaSとして、かれこれ9年にわたり開発運営しています。 最近、その開発にClaude Codeを導入しました。エージェンティックコーディングを可能にするCLIのAIツールです。 最初の試行は失敗に終わったものの、徐々に自分のワークフローに馴染ませることができました。そして先日、アプリ開発がまた「楽しい」と感じられるようになったのです。これは予想外でした。 本稿では、自分がエージェンティック・コーディングをワークフローに取り入れた方法と、それが個人開発への視点をどう変えたかを共有します。 * 翻訳元記事(英語): Agentic coding made programming fun again 自分のアプリに技術的負債が山ほどあった ご想像のとおり、9年も続くサービスをメンテするのは本当に大変です。 初期の頃は新機能の追加も簡単で

By Takuya Matsuyama
個人開発を7年以上続けて分かった技術選択のコツ

個人開発を7年以上続けて分かった技術選択のコツ

個人開発を7年以上続けて分かった技術選択のコツ InkdropというMarkdownノートアプリを作り続けて7年になる。 お陰さまでその売上でずっと生活できている。 これまで個人開発でどう継続していくかについて「ユーザの退会理由をあれこれ考えない」とか「アプリの売上目標を立てるのをやめました」とか、ビジネス面あるいはメンタル面からいろいろ書いてきた。 今回は、技術面にフォーカスして、どう継続して開発していくかについてシェアしたい。 TL;DR * 最初はとにかく最速でリリースする事を最優先する * 迷ったら「ときめく方」を選べ * 程よいところで切り上げて開発を進める * 使っているモジュールがdeprecatedされるなんてザラだと覚悟する * 古いから悪いとは限らない * シンプルにしていく * 老舗から継続の秘訣を学ぶ * 運ゲー要素は排除しきれない 最初はとにかく最速でリリースする事を目標に技術選定する 開発計画とビジネス計画は切っても切り離せない。 コーディングに傾倒するあまり完璧主義に陥って結局リリース出来ないまま頓挫してしまう個人開発者は多い

By Takuya Matsuyama
子育て中の個人開発者の一日

子育て中の個人開発者の一日

子育て中の個人開発者の一日 どうもTAKUYAです。 久しぶりに生活まわりの事を書きたい。自分はInkdropというMarkdownノートアプリを売って生きている。 子供も無事順調に成長しており、あと数ヶ月で3歳になるというところで、イヤイヤ期もやっと終わりが見えてきた。 生活パターンもなんとなく定着しつつあるので、ここで一旦どんなルーティンなのか書き出してみる。ちなみに当方今年で40歳。 平日の1日の流れ * 06:30 妻と子供起床、朝食 * 07:10–30 俺起床、朝食 * 07:40 布団を畳んで子供を着替えさせる。妻はその間に化粧や通勤の準備 * 08:00 ストレッチと軽い筋トレ(腕立て50回、スクワット100回) * 08:10 妻と子供を見送る。15分前後瞑想 * 08:30 散歩 * 09:00 作業開始(カフェまたは家) * 11:00 昼飯 * 12:00 ダラダラする * 12:30 作業再開(だいたい家)

By Takuya Matsuyama