Skip to content

Latest commit

 

History

History
191 lines (134 loc) · 16 KB

README_JP.md

File metadata and controls

191 lines (134 loc) · 16 KB
Raw

アプリ提出ガイド

  • 英語に精通している場合は、英語版の説明をお読みください。
  • 中国語に精通している場合は、中国語版の説明をお読みください。
  • 日本語に精通している場合は、日本語版の説明をお読みください。

あなたの参加を歓迎します

Apple Vision Pro のリリースは、空間コンピューティング時代の到来を予告し、テクノロジーエンスージアストと開発者が新しいインタラクション、システム、ハードウェアで独自の3Dアプリをどう作るか考え始めました。

WWDC 2023の発表以降、ソーシャルメディアには多くの美しいvisionOSアプリのモックアップとデモビデオが溢れていますが、Apple Vision Proはまだ正式にリリースされていないため、他の開発者の作品を試すことは困難です。

この問題を解決するため、私たちはLet’s xrOSというアプリを開発しました。これにより、コミュニティ内の他のクリエイターが開発したvisionOSアプリを試し、空間コンピューティングデバイスの魅力を一足先に体験することができます。

このツールを通じて、開発者間のコミュニケーションがより頻繁になり、コミュニティ全体の発展を促進したいと考えています。

Let’s xrOSはvisionOSアプリの交流プラットフォームで、あなたが開発したvisionOSアプリを世界中のエンスージアストに配布することができます。

ヒント1: 本リポジトリにアプリケーションの本体をアップロードする必要はありません。さらに、Let's xrOS はアプリケーションをオープンソースにすることを強制しません。アプリケーションの配布を開始するために必要なのは、基本的なメタデータをアップロードすることだけです。

ヒント2: こちらはLet’s xrOSのアプリケーション検索リポジトリです。Let’s xrOS上で自分のアプリケーションを公開または更新したい場合は、関連するメタデータファイルを本リポジトリに提出する必要があります。

ヒント3: Let's xrOS アプリケーションをダウンロードしたい場合は、このリポジトリのリリースページからダウンロードしてインストールすることができます。このアプリケーションを通じて、他の開発者が作成したvisionOSアプリケーションを探索することができます。

GitHubで製品を公開する

  • プロジェクトを実行し、visionOSシミュレータでの現在のアプリケーションのバイナリファイルを見つけ、それをapp.zipという名前のZIPパッケージに圧縮し、パッケージ名を変更しないようにしてください。それ以外の場合、アプリ情報の検索に失敗します（操作方法がわからない場合は、FAQの最初の質問を参照してください）。

  • GitHubで現在のアプリのリポジトリを作成します（既に作成している場合はこのステップをスキップしてください）。リポジトリのタイプがPublicであることを確認してください。それ以外の場合、アプリ情報の検索に失敗します。

  • リポジトリのReleaseページに移動し、リリースするタグ番号を選択し、事前に準備したapp.zip圧縮パッケージをアップロードし、対応するReleaseバージョン名を記入します（この名前はタグ番号と同じにすることを推奨します）。

アプリ情報をXReality.Zoneの情報源に提出する

  • フォーク後のリポジトリをローカルにクローンし、新しいブランチを作成します。ブランチ名はapp/Your_App’s_Bundle_IDの形式にします。

  • プラットフォーム上で公開する必要がある各アプリは、XRAppsの下にフォルダを作成し、関連するファイルを含める必要があります。フォルダ名が重複しないように、Bundle IDのような一意性を持つ名前でフォルダを命名することをお勧めします。以下はフォルダの基本構造です：
Folder
  - meta.json 
  - info.json
  - icon.png
  - some_photo.png

meta.jsonはアプリの基本的なメタ情報を保存するために使用され、主にアプリの識別と検索に使用されます。以下は例のファイルです：

{
    "id": "579271a6-b86a-4dae-bbed-f856e830b42d",
    "name": "HelloWorld",
    "icon": "icon.png",
    "version": "1.0.0",
    "compileVersion": "21N5259i",
    "repo": "https://github.com/XRealityZone/what-vision-os-can-do",
    "category": "Developer",
    "bundle": "zone.xreality.WhatVisionOSCanDo",
    "featuredImage": "helloworld-feature.png",
    "slogan": "Meet the visionOS",
}

以下は各フィールドの使用法についての説明です：

フィールド名 必要か 用途
id 必要 アプリの識別子で、UUIDの文字列で、ユーザー自身が生成し、重複してはいけません；Online UUID Generator の V4 を使用して UUID を生成することを推奨します。
name 必要 アプリ名
icon 必要 アプリのアイコンで、512 * 512 のサイズを推奨し、円形に自動カットされます。現在は画像リンクの記入には対応しておらず、すべての画像をフォルダに保存し、JSONファイルで相対パスを使用して呼び出す必要があります。
version 必要 アプリの現在のバージョンで、A.B と A.B.C の2つのフォーマットをサポートしています。
compileVersion 必要 現在のアプリはvisionOSシミュレータのバージョン番号に対応しており、Xcode -> Setting -> Platforms のインターフェースを通じて具体的な情報を確認できます。

| repo | 必要 | アプリの GitHub Repo のアドレスで、アプリをダウンロードするために使用されます。この Repo はソースコードを含む必要はありませんが、GitHubで製品を公開する が完了している必要があります。 | | category | 必要 | アプリのカテゴリーで、以下のフィールドから選択する必要があります：Play、Work、Create、Develop | | bundle | 必要 | アプリの Bundle ID | | featuredImage | 不要 | アプリの特集画像で、1300*800 のサイズを推奨し、追加しない場合、アプリはホームページの特集エリアに表示されません。各画像は1MB以内に抑えてください；現在は画像リンクの記入には対応しておらず、すべての画像をフォルダに保存し、JSONファイルで相対パスを使用して呼び出す必要があります。 | | slogan | 不要 | アプリのスローガンで、featuredImageを記入した場合は、このフィールドを記入する必要があります。 |

info.jsonはアプリの基本内容情報を保存するために使用され、アプリの詳細ページでレンダリングされ表示されます。以下は例のファイルです：

{
    "author": "Ryan Zhu",
    "description": "EyeSightで、あなたの視覚の完全な可能性を解き放ちましょう。EyeSightは、リアルタイムで視覚体験を強化・管理するために設計された画期的なvision OSアプリです。最先端の人工知能と機械学習アルゴリズムを活用して視覚データを分析・解釈し、世界を見る方法を再定義する機能を提供します。\n主な特徴：\n視覚認識の強化：EyeSightはリアルタイムの画像処理とコンピュータビジョンアルゴリズムを使用して、見ている画像やビデオを最適化し、コントラスト、明るさ、鮮明さを調整して、周囲をよりクリアで詳細な視界を提供します。\nオブジェクトとテキストの認識：EyeSightは視界内のオブジェクトとテキストを識別・分類し、見ているものに関する関連情報と文脈を提供します。",
    "developerWebsite": "https://apple.com",
    "images": ["1.png", "2.png", "3.png"]
}

以下は、各フィールドの使用法についての説明です：

| **フィールド名**       | **必要か** | **説明**                                                                   |
| ------------------- | -------- | ------------------------------------------------------------------------ |
| author              | 必要       | アプリ開発者の名前                                                            |
| description         | 必要       | アプリの紹介で、エスケープ文字を使用可能                                             |
| developerWebsite    | 必要       | 開発者のウェブサイト                                                          |
| images              | 必要       | アプリのスクリーンショットで、各画像は1MB以内にしてください；現在は画像リンクの記入はサポートしておらず、全ての画像をフォルダに保存し、JSONファイルで相対パスを使用して呼び出す必要があります。 |
  • 自分のブランチとリポジトリにコミットを提出し、自分のリポジトリからXRealityZoneのリポジトリへのPRリクエストを開始します。

  • XReality.ZoneのスタッフがあなたのPRをレビューし、マージするのを待ちます。あなたのPRがマージされたら、あなたのアプリが私たちの交流プラットフォームに掲載されたことを意味します。

FAQ

Q：visionOSシミュレーターで現在のアプリのバイナリファイルをどこで見つけることができますか？

A:

方法一：Product -> Show Build Folder in Finder からバイナリファイルを見つけます。

方法二：シミュレータ版のバイナリファイルを取得するには、以下の3ステップがあります：

  • 左上隅の Run ボタンをクリックするか、または CMD + R のショートカットキーを使用してあなたのvisionOSプログラムを実行し、コードの実行プラットフォームがvisionOSシミュレーターであることを確認してください。

  • Build Succeeded のプロンプトが表示された後、左側のナビゲーションバーの Product フォルダを展開します。このディレクトリには、1つまたは複数のアプリケーション（.app というサフィックスのファイル）が存在します。あなたのvisionOSアプリを選択し、右クリックして Show in Finder ボタンを選択します。

  • このフォルダ内の .app ファイルが、visionOSシミュレーター下での現在のアプリのバイナリファイルです。

Q: リポジトリの Release インターフェースはどこで見つけることができますか？

A: リポジトリのホームページで Release エリアを見つけることができます。クリックすると Release インターフェースに入ることができます。

Q：自分のリポジトリでどのようにしてタグを作成しますか？

A：Release インターフェースで Choose a tag をクリックし、ドロップダウンリストのテキストボックスにバージョン番号を入力します。入力が完了したら、+ Create new tag A.B.C on publish をクリックします。現在、A.B および A.B.C の2つの形式のバージョン番号をサポートしています。バージョン番号は順番に増やし、逆順にならないようにしてください。

Q: compileVersionまたはvisionOSシミュレータのバージョンを見つける方法は？

A: Xcodeを開き、Xcode -> Setting -> Locations からvisionOSシミュレータを探します。