Issue #1053
Plenty of Mac apps still run on an NSApplicationDelegate. The lifecycle works, the windows are wired up, and rewriting everything into the SwiftUI App protocol just to gain one settings window is hard to justify. The friction shows up the …
Issue #1046
Every app that runs on an Apple device must be signed with a certificate. The signature tells the OS that the code comes from a known developer and hasn’t been tampered with. Xcode manages most of this automatically, but …
Issue #1045
Distributing a macOS app outside the App Store requires notarization. Apple scans the app for malicious content and attaches a ticket to it so Gatekeeper can verify it offline. Without notarization, users on macOS 10.15 and later see a …
Issue #1023
The default Terminal.app works, but it lacks the speed and features that modern development demands. A well-configured terminal setup makes navigation faster, Git operations visual, and file searching instant. This guide walks through …
Issue #1006
When building macOS apps, you often need images that fill their container while keeping their aspect ratio - like cover photos or thumbnails. NSImageView doesn’t do this well out of the box. Here’s how to build a custom …
Issue #1002
I recently set up self-hosted runners on EC2 Mac instances for iOS builds. Here are my notes on what actually works—plus all the gotchas I hit along the way.
For complete official instructions, see GitHub’s guide on adding …
Issue #986
When using TextField in SwiftUI List on Mac, it has unwanted background color when focused. We can turn it off using introspection or a custom TextField wrapper
Issue #981
NSDragOperation represent which operations the dragging source can perform on dragging items.
There are several types of drag operations, and each one has a different purpose and visual cue.
.copyIssue #980
NSCollectionView, available since macOS 10.5+, is a good choice to present a list of content. Let’s make a SwiftUI wrapper for NSCollectionView with diffable data source and compositional layout
Issue #961
NSTextField uses NSFieldEditor under the hood, you can check currentEditor if it is the firstResponder
extension NSTextField {
var …Issue #956
import Foundation
import SwiftUI
import AppKit
struct AttributedTextView: NSViewRepresentable {
@Binding var attributedText: …Issue #951
Create a custom NSView that handles mouseDragged to beginDraggingSession
struct DraggingSourceViewWrapper: NSViewRepresentable {
let fileUrls …Issue #920
For iOS 16 and macOS 13.0
TextEditor(text: $text)
.scrollContentBackground(.hidden)For below, use [SwiftUI-Introspect]( …
Issue #913
Use QuickLookThumbnailing framework
import AppKit
import QuickLookThumbnailing
actor QuicklookService {
static let shared = QuicklookService …Issue #903
let image = NSImage(contentsOf: url)
let imageView = NSImageView(image: image)
image.animates = trueIssue #900
Listen to didActivateApplicationNotification and check that it is not our app
NSWorkspace.shared.notificationCenter
.publisher(for: …Issue #885
Create NSBitmapImageRep with preferred size and draw NSImage onto that.
Need to construct NSBitmapImageRep specifically instead of using convenient initializers like NSBitmapImageRep(data:), NSBitmapImageRep(cgImage:) to avoid device …
Issue #881
Specify optional value for List(selection:).
This keeps selection on macOS, but not on iPad.
On iPad each row in the List needs to be NavigationLink, no need for .tag. The selection is not updated, need to manually update with onTapGesture …
Issue #875
Read newDocument
This method calls openUntitledDocumentAndDisplay(_:).
Read openUntitledDocumentAndDisplay
The default implementation of this method calls defaultType to determine the type of new document to create, calls …
Issue #848
Hold a weak reference to NSWindow, and let system window server manages its lifetime
weak var window = NSWindow()
window.isReleasedWhenClosed = …Issue #822
Get active screen with mouse
func activeScreen() -> NSScreen? {
let mouseLocation = NSEvent.mouseLocation
let screens = NSScreen. …Issue #806
https://developer.apple.com/documentation/appkit/nsapplication/1428590-runmodalsession
Blocks main queue
A loop that uses this method is similar in some ways to a modal event loop run with runModal(for:), except with this …
Issue #795
extension NSImage {
func resize(width: CGFloat, height: CGFloat, padding: CGFloat) -> NSImage {
let img = NSImage(size: CGSize( …Issue #794
I’ve been distributing my apps PastePal and Push Hero as a paid upfront apps on Appstore. I’ve quickly come to realize the importance of trials since many have requested a tryout before purchasing.
Manual sending out trials …
Issue #789
New in SwiftUI 2.0 for iOS 14 and macOS 11.0 is WindwGroup which is used in App protocol. WindowGroup is ideal for document based applications where you can open multiple windows for different content or files. For …
Issue #785
Calling mergeChanges on a managed object context will automatically refresh any managed objects that have changed. This ensures that your context always contains all the latest …
Issue #779
With Xcode 12.4, macOS 11.0 app. Every time we switch the system dark and light mode, the CPU goes up to 100%. Instruments show that there’s an increasing number of ButtonBehavior
Every cell has …
Issue #778
For now using GroupBox has these issues in macOS
Issue #768
Use custom NSWindow, set level in becomeKey and call NSApp.runModal to show modal
final class ModalWindow: NSWindow {
override func becomeKey …Issue #764
Use a custom KeyAwareView that uses an NSView that checks for keyDown method. In case we can’t handle certain keys, call super.keyDown(with: event)
Issue #762
To install, use CocoaPods …
Issue #760
import AppKit
import Omnia
class MyWindow: NSWindow {
override func keyDown(with event: NSEvent) {
super.keyDown(with: event) …Issue #758
extension NSToolbarItem.Identifier {
static let searchItem: NSToolbarItem.Identifier = NSToolbarItem.Identifier("SearchItem")
}
let …Issue #757
Library/LoginItemsIssue #753
This takes a while
Issue #750
Recently when distributing staging releases of my app PastePal via GitHub release or Google Drive, people had hard time opening it
The displayed error is
You do not have permission to open the application
The more verbose error when …
Issue #748
There is said to be PopUpButtonPickerStyle and MenuPickerStyle but these don’t seem to work.
There’s Menu button it shows a dropdown style. We fake it by fading this and overlay with a button. allowsHitTesting does not work, …
Issue #743
• = Apple logo • ⌘ = Command • ⇧ = Shift • ⌫ = Backspace/Delete • ⇪ = Caps lock • ⌥ = Option/Alt • ⌃ = Control • ⎋ = Escape • ←↑→↓ = Arrow Keys • ↩ = Return
Issue #733
NSTextView has this handy method to make scrollable NSTextView NSTextView.scrollableTextView(). The solution is to get to the responder outside enclosing NSScrollView, in my case it is the SwiftUI hosting view
Issue #730
Use NSTextField with maximumNumberOfLines
import AppKit
import SwiftUI
struct AttributedText: NSViewRepresentable {
let attributedString: …Issue #729
@NSApplicationMain
class AppDelegate: NSObject, NSApplicationDelegate {
@IBAction func copy(_ sender: Any) {
print("copy", …Issue #724
We can use .blur modifier, but with VisualEffectView gives us more options for material and blending mode.
public struct VisualEffectView: …Issue #721
For setFrame to take effect
mainWindow.setFrame(rect, display: true)we can remove auto save frame flag
Issue #720
NSStatusItem is backed by NSButton, we can animate this inner button. We need to specify position and anchorPoint for button’s layer so it rotates around its center point
Issue #719
From SwiftUI 2 for macOS 11.0, we have access to Menu for creating menu and submenu. Usually we use Button for interactive menu items and Text for disabled menu items.
The easy way to customize menu with image is to call Menu with content …
Issue #717
Try to use predefined system colors in Human Interface Guidelines for macOS
Here we use this color unemphasizedSelectedTextBackgroundColor for button background
Issue #716
I have an enum that conforms to CaseIterable that I want to show in Picker
enum Position: String, Codable, CaseIterable, Identifiable {
var …Issue #713
To setup toolbar, we need to implement NSToolbarDelegate that provides toolbar items. This delegate is responsible for many things
toolbarDefaultItemIdentifiersitemForItemIdentifier …Issue #710
Starting from macOS 11, we can use List with SidebarListStyle inside NavigationView to declare master detail view. The SidebarListStyle makes list translucent. It automatically handles selection and marks selected row in list with accent …
Issue #707
The trick is to set the button oinside of statusItem to send actions on both leftMouseUp and rightMouseUp.
Another thing to note is we use popUpMenu on NSStatusItem, although it is marked as deprecated on macOS 10.14. We can set menu but …
Issue #703
Read When to refresh a receipt vs restore purchases in iOS?
From iOS 7, every app downloaded from the store has a receipt (for downloading/buying the app) at appStoreReceiptURL. When users purchases something via In App …
Issue #702
The trick is to use an overlay
MessageTextView(text: $input.message)
.overlay(obscure)
var obscure: AnyView {
if store.pricingPlan.isPro …Issue #693
AppKit app has its theme information stored in UserDefaults key AppleInterfaceStyle, if is dark, it contains String Dark.
Another way is to detect appearance via NSView
Issue #689
func applicationDidFinishLaunching(_ aNotification: Notification) {
// extend to title bar
let contentView = ContentView()
// …Issue #681
Only need to specify fixedSize on text to preserve ideal height.
The maximum number of lines is 1 if the value is less than 1. If the value is nil, the text uses as many lines as required. The default is nil.
Issue #680
For List in SwiftUI for macOS, it has default background color because of the enclosing NSScrollView via NSTableView that List uses under the hood. Using listRowBackground also gives no effect
The solution is to use a library like …
Issue #679
While redesigning UI for my app Push Hero, I ended up with an accordion style to toggle section.
It worked great so far, but after 1 collapsing, all image and text views have reduced opacity. This does not happen for other elements like …
Issue #677
The quick way to add new properties without breaking current saved Codable is to declare them as optional. For example if you use EasyStash library to save and load Codable models.
Issue #676
I’ve used the default SwiftUI to achieve the 2 tab views in SwiftUI. It adds a default box around the content and also opinionated paddings. For now on light mode on macOS, the unselected tab has wrong colors.
The way to solve this …
Issue #674
Specify minWidth to ensure miminum width, and use .layoutPriority(1) for the most important pane.
import SwiftUI
struct MainView: View {
@ …Issue #636
Normally we can just wrap NSTextField
struct SearchTextField: NSViewRepresentable {
@Binding var text: String
var hint: String
var …Issue #635
textField.delegate = selfNSTextFieldDelegate …Issue #632
Use Group
private func makeHeader() -> some View {
Group {
if showsSearch {
SearchView(
onSearch: …Issue #630
For SwiftUI app using NSPopover, to show context popover menu, we can ask for windows array, get the _NSPopoverWindow and calculate the position. Note that origin of macOS screen is bottom left
Issue #629
Use Picker with SegmentedPickerStyle.
Picker(selection: $preferenceManager.preference.display, label: EmptyView()) {
Image("grid") …Issue #627
Algorithm from https://www.w3.org/WAI/ER/WD-AERT/#color-contrast
extension NSColor {
var isLight: Bool {
guard
let …Issue #626
SwiftUI does not trigger onAppear and onDisappear like we expect. We can use NSView to trigger
import SwiftUI
struct AppearAware: …Issue #625
For some strange reasons, content inside ForEach does not update with changes in Core Data NSManagedObject. The workaround is to introduce salt, like UUID just to make state change
Issue #624
By default the approaches above grant you access while the app remains open. When you quit the app, any folder access you had is lost.
To gain persistent access to a folder even on subsequent launches, we’ll have to take advantage of a …
Issue #620
For NSWindow having levelother than .normal, need to override key and main property to allow TextField to be focusable
class FocusWindow: …Issue #617
On macOS 11, we can use .help modifier to add tooltip
Button()
.help("Click here to open settings")If you support macOS 10.15, then …
Issue #615
List {
ForEach(books) { (book: Book) in
BookRow(book: book)
}
}
.listStyle(SidebarListStyle()) Issue #612
Use runModal
This method runs a modal event loop for the specified window synchronously. It displays the specified window, makes it key, starts the run loop, and processes events for that window. (You do not need to show the window …
Issue #610
Set NSVisualEffectView as contentView of NSWindow, and our main view as subview of it. Remember to set frame or autoresizing mask as non-direct content view does not get full size as the window
Issue #609
Use animator proxy and animate parameter
var rect = window.frame
rect.frame.origin.x = 1000
NSAnimationContext.runAnimationGroup({ context in …Issue #608
An NSRunningApplication instance for the current application.
NSRunningApplication.currentThe running app instance for the app that receives …
Issue #601
On Xcode 11, applicationWillTerminate is not called because of default automatic termination on in Info.plist. Removing NSSupportsSuddenTermination to trigger will terminate notification
Issue #595
SwiftUI uses ListCoreScrollView and ListCoreClipView under the hood. For now the workaround, is to avoid using List
List {
ForEach
}use …
Issue #593
#if canImport(Combine) is not enough, need to specify in Other Linker Flags
OTHER_LDFLAGS = -weak_framework CombineIssue #590
Use custom NSTextField as it is hard to customize TextFieldStyle
import SwiftUI
struct MaterialTextField: View {
let placeholder: String …Issue #589
import SwiftUI
struct MyTextField: View {
@Binding
var text: String
let placeholder: String
@State
private …Issue #589
class FocusAwareTextField: NSTextField {
var onFocusChange: (Bool) -> Void = { _ in }
override func …Issue #588
class FocusAwareTextField: NSTextField {
var onFocus: () -> Void = {}
var onUnfocus: () -> Void = {}
override func …Issue #587
From https://github.com/twostraws/ControlRoom/blob/main/ControlRoom/NSViewWrappers/TextView.swift
import SwiftUI
/// A wrapper …Issue #585
Follow the new Firebase Crashlytics guide Get started with Firebase Crashlytics using the Firebase Crashlytics SDK
Specify FirebaseCore for community managed macOS version of Firebase
Issue #579
Use same action, or we can roll our own implementation
An NSButton configured as a radio button (with the -buttonType set to NSRadioButton), will now operate in a radio button group for applications linked on 10.8 and later. To have the …
Issue #573
There are 2 Applications folder
Issue #520
Remove quarantine
xattr -d com.apple.quarantine /Applications/Flipper.appIssue #504
https://twitter.com/NeoNacho/status/1181245484867801088?s=20
There’s no way to have platform specific sources or targets today, so you’ll have to take a different approach. I would recommend wrapping all OS specific files in #if os and …
Issue #501
platform :ios, '13.0'
target 'MyApp' do
use_frameworks!
pod 'FirebaseCore'
pod …Issue #458
For push notification, we can now use just Production Certificate for 2 environments (production and sandbox) instead of Development and Production certificates.
Now for code signing, with Xcode 11 …
Issue #443
let textField = NSTextField()
textField.focusRingType = .noneIssue #442
On macOS, coordinate origin is bottom left
let window = NSWindow(contentRect: rect, styleMask: .borderless, backing: .buffered, defer: false) …Issue #439
We need to provide NSLocalizedDescriptionKey inside user info dictionary, otherwise the outputt string may not be what we want.
Issue #438
In Storyboard, NSTextField has an Action option that specify whether Send on Send on Enter only` should be the default behaviour.
In code, NSTextFieldDelegate notifies whenever text field value changes, and target action …
Issue #437
Use Omnia for itemId extension
HeaderCell.swift
final class HeaderCell: NSView, NSCollectionViewSectionHeaderView {
let label: …Issue #436
Open Script Editor, use log command and look for 4 tabs in bottom panel Result, Messages, Events and Replies
log "hello world"Issue #435
Use NSMenu and popUp
func showQuitMenu() {
let menu = NSMenu()
let aboutItem = NSMenuItem(
title: "About",
action …Issue #433
style and isOn propertylet checkButton = NSButton(checkboxWithTitle: "", target: nil, action: nil) …Issue #432
Read Container Directories and File System Access
When you adopt App Sandbox, your application has access to the following locations:
The app container directory. Upon first launch, the operating system creates a special directory for …
Issue #429
Use https://github.com/markedjs/marked
<!doctype html>
<html>
<head>
<meta charset="utf-8"/>
<title>Marked …Issue #428
Need to set target
let item = NSMenuItem(
title: title,
action: #selector(onMenuItemClicked(_:)),
keyEquivalent: ""
)
item. …Issue #427
Use ClickedCollectionView to detect clicked index for context menu.
Embed NSCollectionView inside NSScrollView to enable scrolling
Issue #414
Codable is awesome, but sometimes we just need to quickly get value in a deepy nested JSON. In the same way I did for Dart How to resolve deep json object in Dart, let’s make that in Swift.
See …
Issue #410
import AppKit
import Anchors
class DraggingView: NSView {
var didDrag: ((FileInfo) -> Void)?
let highlightView = NSView() …Issue #409
let stepper = NSStepper()
let textField = NSTextField(wrappingLabelWithString: "\(myLocalCount)")
stepper.integerValue = myLocalCount …Issue #407
https://developer.apple.com/documentation/appkit/nsworkspace/1524399-selectfile
In macOS 10.5 and later, this method does not follow symlinks when selecting the file. If the fullPath parameter contains any symlinks, this method selects …
Issue #406
let progressIndicator = NSProgressIndicator()
progressIndicator.isIndeterminate = true
progressIndicator.style = .spinning
progressIndicator. …Issue #405
Enable Read/Write for User Selected File under Sandbox to avoid bridge absent error
func showSave(
name: String,
window: NSWindow
) async …Issue #404
let animation = CAKeyframeAnimation(keyPath: "position.y")
animation.values = [50, 20, 50]
animation.keyTimes = [0.0, 0.5, 1.0]
animation …Issue #403
The application sends this message to your delegate when the application’s last window is closed. It sends this …
Issue #401
Find identity
security find-identity Sign with entitlements and identity. For macOS, use 3rd Party Mac Developer Application
Issue #339
For simple cases, we don’t need to. Let’s use urlCache
The URL cache for providing cached responses to requests within the session.
The URL Loading System caches responses both in memory and on disk, …
Issue #336
Use NSPopUpButton
var pullsDown: Bool
A Boolean value indicating whether the button displays a pull-down or pop-up menu.
func addItem(withTitle: String)
Adds an item with the specified title to the end of the menu.
Should disable …
Issue #334
NSSecureCoding has been around since iOS 6 and has had some API changes in iOS 12
A protocol that enables encoding and decoding in a manner that is robust against object substitution attacks. …
Issue #332
From moveItem(at:to:)
Moves an item from one location to another in the collection view.
After rearranging items in your data source object, use this method to synchronize those changes with the collection view. Calling this method lets …
Issue #331
From NSSegmentedControl
The features of a segmented control include the following: A segment can have an image, text (label), menu, tooltip, and tag. A segmented control can contain images or text, but not both.
Issue #330
When adding NSTextView in xib, we see it is embedded under NSClipView. But if we try to use NSClipView to replicate what’s in the xib, it does not scroll.
To make it work, we can follow Putting an NSTextView Object in an NSScrollView …
Issue #328
Sometimes we want to validate forms with many fields, for example name, phone, email, and with different rules. If validation fails, we show error message.
We can make simple Validator and Rule
Issue #323
Use proxy animator()
let indexPath = IndexPath(item: index, section: 0)
collectionView.animator().deleteItems(at: Set(arrayLiteral: indexPath)) …Issue #322
lazy var gr = NSClickGestureRecognizer(target: self, action: #selector(onPress(_:)))
gr.buttonMask = 0x2
gr.numberOfClicksRequired = 1
view. …Issue #321
class ClickedCollectionView: NSCollectionView {
var clickedIndex: Int?
override func menu(for event: …Issue #320
NSTextAttachmentCellProtocolRich Text and GraphicsIssue #319
ATSApplicationFontsPath …
Issue #312
class ClosableWindow: NSWindow {
override func close() {
self.orderOut(NSApp)
}
}
let window = ClosableWindow(
contentRect: …Issue #297
let button = NSButton()
button.wantsLayer = true
button.isBordered = false
button.setButtonType(.momentaryChange)
button.attributedTitle = …Issue #296
Original answer https://stackoverflow.com/a/54793979/1418457
In your NSCollectionViewItem subclass, override isSelected and change background color of the layer. Test in macOS 10.14 and Swift 4.2
Issue #274
Original post https://hackernoon.com/20-recommended-utility-apps-for-macos-in-2018-ea494b4db72b
Depending on the need, we have different apps on the mac. As someone who worked mostly with development, below are my indispensable apps. They …
Issue #245
Original post https://medium.com/fantageek/my-favourite-wwdc-2018-sessions-363d3fc9c9d5
This year I failed the lottery ticket to WWDC, and I also missed the keynote live stream because I was sailing on the …
Issue #243
From https://developer.apple.com/documentation/coregraphics/1455137-cgwindowlistcopywindowinfo
Generates and returns information about the selected windows in the current user session.
Issue #242
let window = NSWindow(contentRect: mainScreen.frame, styleMask: .borderless, backing: .buffered, defer: false)
window.level = .floating
window. …Issue #238
“App” is damaged and can’t be opened. You should move it to the Trash.
👉 Disable gate keeper
sudo spctl --master-disable
spctl --statusCurrent …
Issue #233
Shake
let midX = box.layer?.position.x ?? 0
let midY = box.layer?.position.y ?? 0
let animation = …Issue #223
let script =
"""
tell application "XcodeWay"
activate
end tell
"""
let …Issue #217
https://developer.apple.com/documentation/xcode_release_notes/xcode_10_release_notes
The command line tools will search the SDK for system headers by default. However, some software may fail to build correctly against the SDK and require …
Issue #213
Use Runloop
timer = Timer.scheduledTimer(withTimeInterval: 1, repeats: true, block: { [weak self] _ in
let date = Date()
self?. …Issue #205
https://developer.apple.com/documentation/servicemanagement/1501557-smloginitemsetenabled
SMLoginItemSetEnabled
Enable a helper application located in the main application bundle’s “Contents/Library/LoginItems” …
Issue #203
https://developer.apple.com/news/?id=04102019a
With the public release of macOS 10.14.5, we require that all developers creating a Developer ID certificate for the first time notarize their apps, and that all …
Issue #201
Go to both app and extension target, under Capabilities, enable AppGroup
Specify $(TeamIdentifierPrefix)group.com.onmyway133.MyApp
$(TeamIdentifierPrefix) will expand to something like T78DK947F3., with .
Then using is like a …
Issue #200
let home = NSSearchPathForDirectoriesInDomains(.applicationScriptsDirectory, .userDomainMask, true).first!
let path = home.appending( …Issue #178
Install ffmpeg, which installs ffprobe
brew install ffmpegFind location of installed ffmpeg
Issue #177
This is useful to refer to another executable in a running executable in Process
Bundle.main.path(forResource: "ffmpeg", ofType: …Issue #176
Enable executable
chmod +x executableAdd executable file to target
Use Process with correct launchPad
Issue #175
let process = Process()
process.launchPath = "/bin/pwd"
process.arguments = []Should be the same as …
Issue #174
Disable vibrancy mode of NSPopover
let popover = NSPopover()
popover.appearance = NSAppearance(named: NSAppearance.Name.aqua)Issue #173
You might need to flip NSClipView
import AppKit
import Anchors
import Omnia
final class ScrollableStackView: NSView {
final class …Issue #171
var views: NSArray?
NSNib(nibNamed: NSNib.Name("ProfileView"), bundle: nil)?.instantiate(withOwner: nil, topLevelObjects: &views)
let …Issue #140
I need to generate QR code in https://github.com/onmyway133/AddressGenerator. Fortunately with CoreImage filter, it is very easy. Code is in Swift 4
Issue #131
Here’s how to create NSCollectionView programatically. We need to embed it inside NScrollView for scrolling to work. Code is in Swift 4
Issue #94
One thing I like about kickstarter-ios is how they use Playground to quickly protoyping views.
We use Swift Playgrounds for iterative development and styling. Most major screens in the app get a corresponding playground where we can see a …
Issue #91
I’m familiar with the whole app structure that Xcode gives me when I’m creating new macOS project, together with Storyboard. The other day I was reading touch-bar-simulator and see how it declares app using only code. See this …
Issue #86
Today I met a strange problem. After I enter my password, the progress bar runs to the end, and it is stuck there forever. No matter how many times I try to restart.
I finally need to go to Recovery mode by pressing Cmd+R at start up. I …
Issue #34
In an iOS project, we often see this in AppDelegate
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: …Issue #23
Returns whether the constraints impacting the layout of the view incompletely specify the location of the view.
This method randomly changes the frame of a view with an ambiguous layout between …
Issue #6
I like writing with markdown, it gives me comfortable experience with complete control over what I want to write.
I recommend vmd which renders exactly as GitHub. vmd is for rendering only, you need an editor to write, I use Sublime Text …