ローカルに保存した画像ファイルをNSImageとして表示したい

Question

前提・実現したいこと

SwiftとCocoaフレームワークを利用して、macOS向けのアプリケーションを開発しております。
ユーザが指定した絶対パスに格納された画像ファイル(.gif)を、NSImageViewの子ビューとして表示させたいです。

なお、NSImageViewについて、StoryboardからAnimatesおよびEditableプロパティにはチェックを入れております。

また、プロジェクトフォルダ内に同じ画像ファイルを配置し、StoryboardからImage Cellのimageプロパティとして画像ファイルをファイル名で指定すると表示されることは確認できております。

発生している問題・エラーメッセージ

NSImageViewのimageプロパティにURLを内部的に保持するNSImageオブジェクトをセットしましたが、表示されません。
また、URLの整合性や生成したNSImageのisValidプロパティを確認してみたところ、NSImage#isValid == falseとなっていたことから、NSImageインスタンスの生成の仕方が間違えているとは思うのですが、どう直せば有効なNSImageインスタンスが生成でき、最終的にNSImageViewに反映できるのかが分かりません。

該当のソースコード

/// アプリケーションウィンドウのコンテンツを管理するクラス
class ViewController: NSViewController {

  @IBOutlet weak var imageView: NSImageView!

  override func viewDidLoad() {
    super.viewDidLoad()

    let isExists: Bool = FileManager.default.fileExists(atPath: "/Users/b150005/Downloads/sample1.gif")
    print(isExists)  // 確認用
    print(NSImage(byReferencing: URL(fileURLWithPath: "/Users/b150005/Downloads/sample1.gif")).isValid)  // 検証用

    if (isExists) {
      // NSImageViewに表示させる画像(NSImage)の指定
      imageView.image = NSImage(byReferencing: URL(fileURLWithPath: "/Users/b150005/Downloads/sample1.gif"))
    }
  }
}

実行結果

true
false

試したこと

とりあえずNSImage#isValidがtrueとなるように以下を試しました。

①NSImageのイニシャライザを変えてみる
・NSImage(contentsOfFile: "file:///Users/b150005/Downloads/sample1.gif")?.isValid
→ nil

・NSImage(contentsOf: URL(fileURLWithPath: "file:///Users/b150005/Downloads/sample1.gif"))?.isValid
→ nil

・NSImage(byReferencing: URL(string: "file:///Users/b150005/Downloads/sample1.gif")!).isValid
→ false

②URL文字列を変えてみる
・"file:///Users/b150005/Downloads/sample1.gif"
・"/Users/b150005/Downloads/sample1.gif"
→ 一部のイニシャライザを除き変化なし
→ URL(string:)では下記の(ランタイム)エラーメッセージが表示されました。

nsurlconnection finished with error 1002

補足情報（FW/ツールのバージョンなど）

OS: macOS Big Sur
CPU: Intel Core i7(3.8GHz@8 core)

Comments

[退会済みユーザー]

回答を放置されていますがどうかされましたか？質問の意図と異なり解決に関係ない回答である場合はその旨ご指摘頂き質問にご反映下さい。

Answer 1

原則、NSSearchPathForDirectoriesInDomains を使ってディレクトリパスを取得し、それにファイルまでのパスを付け足すようにします。

.downloadsDirectory で「ダウンロード」ディレクトリを、.userDomainMask でアプリを実行しているユーザのディレクトリとして検索する事を指定します。最後の true は ~/... というパスのチルダ ~ を絶対パスとして展開するかどうかです。デバッグする上では展開しておいた方が明確です。

override func viewDidLoad() {
  super.viewDidLoad()
  
  if var path = NSSearchPathForDirectoriesInDomains(
    .downloadsDirectory, .userDomainMask, true
  ).first {
    path.append("/sample1.gif")
    
    if let image = NSImage(contentsOfFile: path) {
      self.imageView.image = image
    } else {
      print("画像ファイルがありませんでした")
    }
  }
}

また、アクセスするディレクトリのパーミッションを要求するのを忘れないで下さい。

Comments

[b150005]

お返事が遅くなって申し訳ありませんでした。
ycv57u6yさんが仰っていた通りに試してみると、無事表示させることができました。

FileManagerに`NSSearchPathForDirectoriesInDomains(_:_:_:)`というメソッドがあるんですね..
FileManagerについてもう少し勉強して、分かった範囲で情報を追記したいと思います。
迅速なご回答をいただき助かりました。ありがとうございました。