I’ve been using Xcode’s new memory graph debugger for just about a day, so I don’t have a ton to share here, but I do have a few things.
To start, hit the rotated Sleestak-fingers button in the debugger. It’s between the Cyberman button (view debugger) and paper airplane (location simulator). In other words: it’s not in Instruments. It’s in Xcode.
Turn off zombies. If your scheme has zombies on, you’re going to get a bunch of extra noise. (Tip: keep zombies off in general until you need them.)
Turn on Malloc Stack Logging in Diagnostics in your scheme. (I think I have it right that this needs to be on in order for the memory graph debugger to show backtraces.)
Open the right-hand sidebar in Xcode. Clicking on an object shows its class, hierarchy, and backtrace.
Lines between objects have a label. A line represents a reference. Click on the label to see if the reference is strong or weak or unknown and what the source and destination are.
Don’t click on anything where the name looks something like
MagicOb(something like that). It crashes Xcode for me every time.
Click on the circle-with-double-arrows to expand a tree. To unexpand, click again in that same spot. (The arrows point inward now instead of outward.) However, there’s a bug where sometimes this disappears. Select something else in the left-hand sidebar and then come back, and the collapse arrows should appear.
In the left-hand sidebar, look for the purple icon with the ! inside. These indicate possible problems.
However, most problems aren’t detected. It’s up to you go through and see what’s hanging around that should not be.
I’ve fixed two bugs using the memory graph debugger, and I saved a bunch of time in both occasions. It’s probably worth telling about them as a reminder of the kinds of problems you can run into.
An NSNotification observer was set up using a block — which is something I myself don’t do, since it litters an init or viewDidLoad with extraneous code and since it’s dangerous.
It’s dangerous because, unless you remember to be careful, it can capture a strong reference to self, and then that object is never going to go away. I don’t like APIs that require the developer to remember extra things like this.
And, sure enough, this was one of those cases.
The tipoff was in the memory graph debugger: the reference was labelled as “capture,” which let me know there was a block doing a capture, and it was then pretty quick to find out where.
(See also, from 2015: How Not to Crash #3: NSNotification.)
View controller / view retain cycle
There’s a general rule of programming that says objects should know about their children but not about their parents.
However, sometimes a view needs to know about its view controller. This is less than ideal, but sometimes it’s the least-bad option. (Well… I’m skeptical — but it happens, and we ship great apps, so there ya go.)
The related rule of programming says that if a child knows about its parent, it still can’t hold a strong reference to its parent.
That’s what was happening here: a view was retaining its view controller. The simple fix was to make that a weak property.
And, again, the memory graph debugger took me right to this. I could see what was happening inside the app in a way I never could before.
It’s marvelous. You should use it.
Adam Rush interviewed me for raywenderlich.com.
Adam asks me about public speaking, and I reply that I have the goal of “making it seem like nothing, as if I just got up and started talking to you” — which is more of a peek into my head than it sounds like.
I remind myself to make it seem like nothing many times per day. Not just with public speaking but especially with writing words and apps.
I think I mean a few different things by that. Don’t be show-offy. Don’t be self-conscious. Don’t do fancy or clever things just because I can. Make it look easy and effortless.
I don’t claim that I succeed at all this — just that that’s my aesthetic mantra.
I was a guest on the Supertop podcast a couple weeks ago, and I spaced on linking to it.
Here’s the podcast. It’s made by the fine folks who make Unread and Castro. (I’m an Unread user. It’s in my iPhone’s dock, even.)
(I’d check out Castro except that I actually don’t listen to podcasts on my iPhone. I listen to them at work via my iTunes on my Mac. Which is dreadfully weird of me, I know.)
One way to explain Donald Trump is to think of him as a fourth-grader who desperately wants the approval of the cool kids. He wants to be in their club.
And then, when he feels like he doesn’t get that approval and respect and an invitation to join in — whether the club is Manhattan society, the billionaire’s club, the serious politicians club — he feels like that approval has been withheld unfairly. The cool kids have it rigged against him.
Well, in the face of that unfairness, retaliation against the cool kids by any means necessary — any bullshit and lies whatsoever — is completely justified. They’re evil, and he’s better than them, and whatever it takes to prove that is within bounds.
(One well-trodden route here is the populist option, as if to say, “Those cool kids all think they’re cool, but real people know better. They know I’m the cool one.”)
Children do this sometimes, and it’s awful, and they learn and they grow up.
When adults do it, it’s because they’re psychos.
Some random notes on my secret project Mac app…
* * *
It’s very close to what I call the Minimally Usable Milestone (MUM). That doesn’t mean all the features are all there — or even that they’re all designed — but that you could use the app for its main purpose, if you don’t mind all the unfinished parts.
This is pretty exciting for me. What this means is that the app has good bones, and now it’s a matter of implementing commands, doing some side windows, that kind of thing. It’s still a ton of work, but it’s rewarding in a specific way: every bit of progress is something I can see and use. Up until now it’s mostly been programming-by-faith.
The app has taken a long time to get to this point for a few reasons. One is that I was working on two apps at the same time. I realized that it wasn’t realistic to do two — so I picked the one I wanted to do the most.
Another is that I work in bits and pieces — 15 minutes here and there, and when I’m lucky a few hours in a row on the weekend. As long as the work is steady I don’t lose context — and even 15 minutes a day adds up after a while (especially as you consider that some of the work is thinking work that happens in the shower, on the bus, and so on).
A third is that I have the luxury of shipping whenever, which means my process goes like this: write the code to understand the problem, then write it again now that I understand it. It’s not fast, but I do it this way because it’s super-important to me that I don’t have to do major surgery later. The bones, the foundation of the app, should need only minimal attention after 1.0.
* * *
I don’t know when the beta will be. I don’t know if it will be public or not. But it won’t go into beta until 1) there are no known crashing bugs, 2) there are no known bugs, and 3) it’s fast. (Of those three, the hard one is really #2.)
However, there will be testers who see it before it hits beta. I like early feedback. But even that is still a ways away.
* * *
All of the code at the app level is in Swift. There are about 10 frameworks (modules) that the app uses: some could conceivably be used in other apps, and others are app-specific. The oldest of these still has a bunch of Objective-C code, while newer modules are in Swift. It’s rare that I write a new line of Objective-C.
I like not just writing modular code but actually enforcing that by using actual modules. Though some modules may depend on lower-level modules, they’re each otherwise self-contained, with their own tests and so on. I like to be able to focus: I select the module in that popup in the Xcode toolbar, and then just work on it and forget about everything else.
* * *
I’ve found a simple organization pattern that I like for my Swift code.
- Properties at the top.
- Init methods
- Public or internal methods.
- Then a
private extension. The public/internal methods can see into the extension, but nothing else can. (This way I never have to mark an individual func as private.)
I also make heavy use of
// MARK: Whatever for organization.
I do not make separate extensions for protocol conformance methods. I tried it and it felt too busy. Instead I just have public/internal and then the private extension.
I also mark things as
final all the damn time. Subclasses are the devil’s classes. I’m a big fan of protocol-oriented-programming.
And: my methods tend to be small. This is probably a function of my available time — I break things into smaller chunks, because I only have time for a small chunk. It’s probably also a function of my having to enlarge my font size in Xcode. Something in my brain responds to the actual physical on-screen size and not the number of lines of code.
* * *
I keep the app to-do list in OmniOutliner (which I work on at my day job), since app to-do lists are hierarchical. I’ve been using an outliner for this purpose since the ’90s, and OmniOutliner specifically for probably more than ten years. I have no idea if anybody else does this, but for me it works great.
I will use a bug tracker later, of course, but for now there’s no need. A big flat list would be unwieldy at this point. I need to see the structure of what needs to be done, and I need to expand and collapse so I can focus. (Obviously OmniFocus might also be good for this purpose.)
I use OmniOutliner very simply. Hide the toolbar. Hide the inspector. One column only. No status checkbox — I just delete lines as they’re completed (because otherwise they add noise).
* * *
Next up on the Secret Project Diary — I’m not sure when — I plan to write about the app I’m not doing. The one that got away.
I spent hours on this. This post exists for anybody Googling this particular problem.
Here’s the issue: I have a mixed Objective-C and Swift app.
I have a Swift class that needs to observe a Notification (aka NSNotification) posted in Objective-C code. The notification name is defined in a .h and .m file:
extern NSString *SomethingHappenedNotification;
NSString *SomethingHappenedNotification = @"SomethingHappenedNotification";
In Swift I tried a number of permutations, trying to get the notification name correct, including using
Notification.Name(rawValue: SomethingHappenedNotification) and similar. Each try resulted in a compile error.
The answer came from Tim Ekl (privately) and Jordan Rose (on Twitter) independently at the same time:
Ah, the word "Notification" is stripped from the name as redundant, so it becomes Notification .Name.Some (or just .Some).
In other words, the syntax for adding an observer looks like this:
NotificationCenter.default.addObserver(self, selector: #selector(someSelector(_:)), name: .SomethingHappened, object: nil)
Note that the Objective-C name
SomethingHappenedNotification becomes just
.SomethingHappened in Swift, and it’s automatically a Notification.Name.
It seems obvious now! But it wasn’t (at least for me). So: if I saved you some time today, then go be nice to somebody. :)
When I was a kid, one adult said to me about another adult: “It must be so lonely to be the only person who’s right all the time.”
To me, then and now, this sounded like a devastating put-down.
This made me think about the importance of being right. Everyone likes to be right, I suppose — it’s human nature. But it made me question something I hadn’t thought to question: how important is it, really, to be right?
Is it more important than being kind? Is it more important than working hard? Or learning? Or listening? Or enjoying the company of other people?
I concluded that being right is not only less important than a whole bunch of other things, it actually gets in the way of other more important things.
Sync Shutdown Tonight
We will turn off Vesper’s syncing service tonight at 8pm Pacific. Though syncing will stop working, other things won’t.
Data is stored on your device. The app will continue to work even without syncing. You can continue to use the app.
You can still export your data. As many times as you want. The Export feature works with the data on your device — it has nothing to do with syncing.
We plan to remove the app from the App Store Sept. 15, but you can continue to use the app even after that. The Export feature will continue to work after that.
I think that covers everything, but I may update this post if we find people asking questions that haven’t been covered by the above.
Open Source Plans
We plan to do all of the below by the end of 2016, but we can’t make promises. (Life may intervene.)
Q Branch’s existing open source code — DB5 and QSKit — will be moved to my personal GitHub account. I will continue to maintain DB5 (I continue to use it). QSKit will not be maintained, but will be made available as historical artifact.
The licenses will be public domain or something roughly as non-restrictive. However: the name Vesper and the app icon remain the property of me, Dave, and John. If you build anything based on this code, you must pick a different name and different app icon.
Before being posted, Vesper for iOS will be revised so that it uses the default system font, since we can’t ship Ideal Sans as part of this. I’ll probably also adopt Dynamic Type as part of this work. (Since it’s the right thing to do.)
Vesper for Mac is most definitely incomplete.
The syncing backend runs on Azure Mobile Services, which is Node.js plus a bunch of goodies. It’s not something you can just upload and run anywhere — but the code might still be useful to look at.
In Vesper there is good code and bad code and so-so code. Part of the fun of this will be me writing blog posts ripping apart the bad code. You have no idea how much I’m looking forward to that. :)
Something that hasn’t been written about Vesper: it had the best beta test I’ve ever been a part of.
We used Glassboard, which worked very nicely for discussion. I knew it would work because we had used Glassboard to beta-test Glassboard.
The greatest beta testing group I’ve ever been a part of was the NetNewsWire beta mailing list. It was a discussion mailing list originally hosted at notabug.com (which breaks my heart to remember), and later at ranchero.com.
It had a couple dozen pretty active people and a few dozen more who didn’t post quite as often. What I would do is post super-early builds — not even betas, not even alphas, but development builds right off my machine — and we’d talk over everything.
Not just bugs but every detail large and small, every idea, every feature request, every aspect of design and behavior. Even though NetNewsWire was my thing, it was very much a collaboration with a great bunch of people. That collaboration played a major role in the quality and success of the app. I’ve thanked those people and thank them again.
From the outside it may not have looked like it, but development of NetNewsWire was always a very social experience. (Same with MarsEdit.)
And the thing I miss most about NetNewsWire is that mailing list.
* * *
This style of beta testing isn’t something I just accidentally fell into. It came from the mid-’90s. UserLand had just released Frontier’s free “Aretha” version, and there was a mailing list for people using Aretha.
I’d never been a part of anything like that. There were all these people talking about everything about the app. It was collegial and interesting and fun — and Dave Winer, the developer, was so open about everything, and he listened. It seemed like a miracle to me that such a thing could exist. I loved it. I’d been waiting all my life for such a thing, for a community like this.
I threw myself into it, then ended up working with Dave informally on some small projects, and later took a job at UserLand (which was my dream job, for sure).
(Another great mailing list at the time was Chuck Shotton’s list for MacHTTP, later named WebSTAR. I was an enthusiastic, though not at all accomplished, developer of WebSTAR plugins. I made $0 on my plugins! But I loved writing them.)
When my time at UserLand ended in 2002, and I started working on NetNewsWire, one of the first things I did was start a new mailing list, and some of my friends from the Frontier community joined me on the NetNewsWire list, and they formed the seed and the backbone of the NetNewsWire mailing list.
It might seem funny to think of beta lists as having children and grandchildren, but the NetNewsWire list was very much the child of the Frontier list, and the Glassboard and Vesper lists were the grandchildren.
* * *
Anyway: that’s how you do beta testing. Get good people and let them talk things over. And listen.
* * *
One of the rules I’ve used — which I probably got from Dave — is not to argue with “I bet lots of people are like me and want feature X,” but instead say why you specifically want feature X, or why you’d prefer some behavior or design change.
In other words: instead of just asserting that a thing would be better or more popular if done a different way, tell a story with details.
Maybe that’s not right for every beta test, but that’s what works for me. I like stories. A single person can convince me with a good story. Voting is not necessary or desired.
Some people — people I respect — have asked why we didn’t make Vesper a web app from the start.
Or: why not make it a web app now? Surely it would be cheaper to run, and you wouldn’t have to worry about syncing or about keeping up with changes to iOS.
Well, we did want to do a web app. We worked with Alex King, who got pretty far along on the design. In those days there was no Apple-provided syncing system with web services (there is now), so we wrote our own sync system in part because we wanted to make a web app.
And: all three of us love the web. We have blogs and podcasts and videos on the web. My longest-running “product” is this very site — it’s 17 years old, and of everything I’ve ever done it’s the thing I’m most proud of.
But we didn’t get together to make web apps. We love making iOS and Mac apps, and we don’t love making web apps. We’d do it, but it’s not our passion. (Well, we would have had Alex King’s team do it, actually.)
There’s a difference between loving the web and loving making web apps.
Way back in 2002 I wrote Why I Develop for Mac OS X — it’s because of what Joel Spolsky called an “emotional appeal.” I wrote:
But to me it’s the difference between an empty night sky and a night sky with all the stars shining and a big, bright bella luna. “Emotional appeal?” Oh yes indeed. And I don’t apologize for that for one second.
It’s still true, 14 years later. And it’s why Vesper didn’t start as a web app, and why we’re not converting it now.