如何为Mac创建Cocoa App首选项？

Question

我在Xcode for Mac中创建了一个简单的应用程序，它可以构建和编译。

如何为首选项创建菜单？有简单的方法还是我必须创建一个新的界面？然后，我如何获取并将值放入这些首选项中？

我确实找到了一个教程，但是它适用于iOS，而且我可以看到，如果您正在为Mac开发，那么“设置包”不可用。

编辑：以下链接是完美的：https://developer.apple.com/cocoa/cocoabindings.html

Answer 1

This is the documentation you want.更具体地说How to provide a Preferences Interface。

无论如何，您必须像创建任何其他窗口一样创建自己的首选项菜单/窗口，并且有一些控件允许修改随后存储在User Defaults字典中的值，这是通常存储用户首选项的位置（a Cocoa Bindings制作的过程非常简单）。

否则，手动，您可能需要引用[NSUserDefaults standardUserDefaults]，以便您可以-setObject:ForKey:等等。阅读与上面链接的整个文档（包括其他部分）是明智的。

有关如何使用Cocoa绑定与NSUserDefaults进行交互以存储/检索首选项的更多信息，请参阅Apple docs here。

Answer 2

对于窗口本身，我会推荐RHPreferences框架。

可在GitHub上找到。 BSD许可。

它是一个简单易用的首选项窗口控制器，具有多个选项卡，可用于下一个Mac应

它还提供：

• 在不同大小的选项卡视图之间自动调整大小（带动画）
• 自定义NSToolbarItem支持
• 最后使用的选项卡的持久性
• 支持占位符NSToolbarItems（例如NSToolbarFlexibleSpaceItemIdentifier和NSToolbarShowFontsItemIdentifier）

Answer 3

Apple's documentation is probably what you want to look through.

Answer 4

NSTabViewController.TabStyle.toolbar - 一种自动将任何选项卡添加到窗口工具栏的样式。选项卡视图控制器控制窗口的工具栏并将其自身设置为工具栏的委托。

https://developer.apple.com/documentation/appkit/nstabviewcontroller/tabstyle

请记住，我们可以创建NSWindowController，将NSWindow.contentViewController设置为NSTabViewController，以获得标准的macOS首选项窗口。

这是一个由代码（Swift 4）制作的Preferences窗口：

文件：PreferencesPageID.swift - 保留首选项页面属性。用于回调。

enum PreferencesPageID: Int, CaseIterable {

   case generic, misc

   var image: NSImage? {
      switch self {
      case .generic:
         return NSImage(named: NSImage.folderSmartName)
      case .misc:
         return NSImage(named: NSImage.networkName)
      }
   }

   var title: String {
      switch self {
      case .generic:
         return "Some"
      case .misc:
         return "Other"
      }
   }
}

文件：PreferencesTabView.swift - 表示首选项页面内容视图。

class PreferencesTabView: View {

   let id: PreferencesPageID

   init(id: PreferencesPageID) {
      self.id = id
      super.init()
   }

   required init?(coder decoder: NSCoder) {
      fatalError()
   }

   override func setupUI() {
      switch id {
      case .generic:
         backgroundColor = .red
         setIntrinsicContentSize(CGSize(width: 400, height: 200))
      case .misc:
         backgroundColor = .blue
         setIntrinsicContentSize(CGSize(width: 400, height: 300))
      }
   }
}

File：PreferenceItemViewController.swift - 保留Preference页面内容视图的Controller。主要需要满足macOS SDK要求。

class PreferenceItemViewController: ViewController {

   private let contentView: PreferencesTabView

   override func loadView() {
      view = contentView
   }

   init(view: PreferencesTabView) {
      contentView = view
      super.init(nibName: nil, bundle: nil)
   }

   required init?(coder: NSCoder) {
      fatalError()
   }    

   override func viewDidLayout() {
       super.viewDidLayout()
       preferredContentSize = view.intrinsicContentSize
   }    
}

文件：PreferencesViewController.swift - 用作NSWindow.contentViewController。

class PreferencesViewController: TabViewController {

   enum Event {
      case selected(PreferencesPageID)
   }

   var eventHandler: ((Event) -> Void)?


   override func setupUI() {
      tabStyle = .toolbar // This will "turn" View Controller to standard Preferences window.
      transitionOptions = .allowUserInteraction
      canPropagateSelectedChildViewControllerTitle = false
      let views = [PreferencesTabView(id: .generic), PreferencesTabView(id: .misc)]
      views.forEach {
         let item = NSTabViewItem(viewController: PreferenceItemViewController(view: $0))
         item.label = $0.id.title
         item.image = $0.id.image
         addTabViewItem(item)
      }
   }

   override func tabView(_ tabView: NSTabView, didSelect tabViewItem: NSTabViewItem?) {
      super.tabView(tabView, didSelect: tabViewItem)
      if let view = tabViewItem?.viewController?.view as? PreferencesTabView {
         eventHandler?(.selected(view.id))
      }
   }

}

文件：PreferencesWindowController.swift - 首选项窗口控制器。

private class PreferencesWindowController: NSWindowController {

   private(set) lazy var viewController = PreferencesViewController()

   init() {
      let rect = CGRect(x: 400, y: 200, width: 400, height: 300)
      let window = NSWindow(contentRect: rect, styleMask: [.titled, .closable], backing: .buffered, defer: true)
      super.init(window: window)

      setupHandlers()

      let frameSize = window.contentRect(forFrameRect: window.frame).size
      viewController.view.setFrameSize(frameSize)
      window.contentViewController = viewController
   }

   required init?(coder: NSCoder) {
      fatalError()
   }

   // MARK: - Private

   private func setupHandlers() {
      viewController.eventHandler = { [weak self] in
         switch $0 {
         case .selected(let id):
            self?.window?.title = "Preferences — " + id.title
         }
      }
   }

}

用法：

public class Application: NSApplication {

   private lazy var preferencesController = PreferencesWindowController()

   // Called from code or via IBAction
   private func showPreferences() {
      preferencesController.showWindow(nil)
   }

}

Answer 5

在项目的MainMenu.xib中，您将在单击应用程序名称后看到下拉列表。 Cntrl + Click +将Preferences拖动到项目的AppDelegate.h文件并创建和IBAction方法。

使用xib创建一个带有NSWindowController（PreferenceWindowController）的类，创建该PreferenceWindowController的强属性，为其分配init并在AppDelegate.m中添加[self.preferenceWindowController showWindow:self];。这将为您的OS X应用程序创建一个Preferences窗口。

Answer 6

为每个首选项窗格创建一个.nib和一个控制器（.h和.m）。然后在应用程序的AppDelegate.m中动态连接它们。我在我的应用程序中使用它，它由一些动态加载的包组成，这样每个包都有自己的首选项。

你可以在这里看到一个非常好的简洁例子：http://www.knowstack.com/nstoolbar-sample-code-objectivec/

在此示例中，它动态创建NSToolbar和NSToolbarItem。您在每个首选项窗格的每个窗口控制器中执行的操作由您决定。

这是AppDelegate.m的主要部分：

//  AppDelegate.m
//  CocoaToolBars
//  Created by Debasis Das on 4/30/15.
//  Copyright (c) 2015 Knowstack. All rights reserved.

#import "AppDelegate.h"
@interface AppDelegate ()
@property (weak) IBOutlet NSWindow *window;
@end

@implementation AppDelegate

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
  // Insert code here to initialize your application
  _toolbarTabsArray = [self toolbarItems];
  _toolbarTabsIdentifierArray = [NSMutableArray new];

  for (NSDictionary *dict in _toolbarTabsArray){
    [_toolbarTabsIdentifierArray addObject:dict[@"identifier"]];
  }
  _toolbar = [[NSToolbar alloc]    initWithIdentifier:@"ScreenNameToolbarIdentifier"];
  _toolbar.allowsUserCustomization = YES;
  _toolbar.delegate = self;
  self.window.toolbar = _toolbar;
}  

-(NSArray *)toolbarItems {
  NSArray *toolbarItemsArray = [NSArray arrayWithObjects:
                               [NSDictionary    dictionaryWithObjectsAndKeys:@"Find Departments",@"title",@"Department-50",@"icon",@"DepartmentViewController",@"class",@"DepartmentViewController",@"identifier", nil],
                              [NSDictionary dictionaryWithObjectsAndKeys:@"Find Accounts",@"title",@"Business-50",@"icon",@"AccountViewController",@"class",@"AccountViewController",@"identifier", nil],
                              [NSDictionary dictionaryWithObjectsAndKeys:@"Find Employees",@"title",@"Edit User-50",@"icon",@"EmployeeViewController",@"class",@"EmployeeViewController",@"identifier", nil],
                              nil];
  return  toolbarItemsArray;
}

- (void)applicationWillTerminate:(NSNotification *)aNotification {
  // Insert code here to tear down your application
}

- (NSToolbarItem *)toolbar:(NSToolbar *)toolbar
   itemForItemIdentifier:(NSString *)itemIdentifier willBeInsertedIntoToolbar:(BOOL)flag {
  NSDictionary *itemInfo = nil;

  for (NSDictionary *dict in _toolbarTabsArray) {
    if([dict[@"identifier"] isEqualToString:itemIdentifier]) {
      itemInfo = dict;
      break;
    }
  }

  NSAssert(itemInfo, @"Could not find preferences item: %@", itemIdentifier);

  NSImage *icon = [NSImage imageNamed:itemInfo[@"icon"]];
  if(!icon) {
    icon = [NSImage imageNamed:NSImageNamePreferencesGeneral];
  }
  NSToolbarItem *item = [[NSToolbarItem alloc] initWithItemIdentifier:itemIdentifier];
  item.label = itemInfo[@"title"];
  item.image = icon;
  item.target = self;
  item.action = @selector(viewSelected:);
  return item;
}

-(void)viewSelected:(id)sender {
  NSToolbarItem *item = sender;
  [self loadViewWithIdentifier:item.itemIdentifier withAnimation:YES];
}

-(void)loadViewWithIdentifier:(NSString *)viewTabIdentifier
                      withAnimation:(BOOL)shouldAnimate {
  NSLog(@"viewTabIdentifier %@",viewTabIdentifier);

  if ([_currentView isEqualToString:viewTabIdentifier]) {
    return;
  } else {
    _currentView = viewTabIdentifier;
  }
  //Loop through the view array and find out the class to load

  NSDictionary *viewInfoDict = nil;
  for (NSDictionary *dict in _toolbarTabsArray) {
    if ([dict[@"identifier"] isEqualToString:viewTabIdentifier]) {
      viewInfoDict = dict;
      break;
    }
  }
  NSString *class = viewInfoDict[@"class"];
  if(NSClassFromString(class)) {
    _currentViewController = [[NSClassFromString(class) alloc] init];
    NSView *newView = _currentViewController.view;

    NSRect windowRect = self.window.frame;
    NSRect currentViewRect = newView.frame;

    windowRect.origin.y = windowRect.origin.y + (windowRect.size.height - currentViewRect.size.height);
    windowRect.size.height = currentViewRect.size.height;
    windowRect.size.width = currentViewRect.size.width;

    self.window.title = viewInfoDict[@"title"];
    [self.window setContentView:newView];
    [self.window setFrame:windowRect display:YES animate:shouldAnimate];      
  } else {
    NSAssert(false, @"Couldn't load %@", class);
  }
}

- (NSArray *)toolbarDefaultItemIdentifiers:(NSToolbar *)toolbar {
  NSLog(@"%s %@",__func__,_toolbarTabsIdentifierArray);
  return _toolbarTabsIdentifierArray;
}

- (NSArray *)toolbarAllowedItemIdentifiers:(NSToolbar *)toolbar {
  NSLog(@"%s",__func__);
  return [self toolbarDefaultItemIdentifiers:toolbar];
}

- (NSArray *)toolbarSelectableItemIdentifiers:(NSToolbar *)toolbar {
  NSLog(@"%s",__func__);
return [self toolbarDefaultItemIdentifiers:toolbar];
}

- (void)toolbarWillAddItem:(NSNotification *)notification {
  NSLog(@"%s",__func__);
}

- (void)toolbarDidRemoveItem:(NSNotification *)notification {
  NSLog(@"%s",__func__);
}

@end