Skip to main content

ビルドでのファイルの使用

概要

ビルドでファイルを使用するには、ワークフローでファイルダウンローダーのようなステップを使用してファイルをダウンロードするか、ファイルの自動生成されたEnvVarをステップ入力として使用できます。

Bitriseビルドでファイルを使用する方法は複数あります。

  • ファイルを生成するほとんどのステップは、ファイルパスを出力環境変数(Env Var)に格納します。同じワークフローの後続のステップでは、そのEnvVarを再利用してファイルにアクセスできます。

  • あなたはできる 汎用ファイルストレージにファイルをアップロードする そして、URLを入力として受け入れるステップで、自動生成されたEnvVarをステップ入力値として使用します。

  • あなたはできる 汎用ファイルストレージにファイルをアップロードする ステップの1つを使用します(たとえば、 ファイルダウンローダー ステップ)ビルド用のファイルをダウンロードします。これは、ローカルファイルパスを必要とするステップで機能するため、入力値としてURLを直接サポートしません。

ファイルダウンローダーステップを使用してファイルをダウンロードする

ビルド内のファイルにアクセスする方法の 1 つは、 ファイルダウンローダー ステップ。このステップは、ローカル パスのみを値として受け入れるファイルをステップ入力で使用する必要がある場合に便利です。

ステップは指定した場所にファイルをダウンロードし、その後のすべてのステップはその場所にあるファイルにアクセスできます。

ワークフローエディター

ビットライズ.yml

  1. クリック edit-webhook.svg ワークフロー名の横にあるボタンをクリックします。

  2. 追加します ファイルダウンローダー ワークフローに進みます。

  3. の中に ソースURLをダウンロード 入力に、ファイルが見つかる場所を追加します。

    アップロードされたファイルのダウンロード URL を見つける

    もし、あんたが ファイルをBitriseにアップロードしました、ダウンロード URL は次の場所にあります。 ファイル のセクション アプリの設定 ページ。

  4. の中に 宛先パスをダウンロードする 入力には、ファイルをダウンロードするパスを指定します。リポジトリのルートからの相対パスである必要があります。

    入力値としてEnvVarを使用する

    入力に直接指定する代わりに、ファイルパスをApp EnvVarに保存できます。そうすれば、他のステップでEnv Varを介してファイルを参照できるため、毎回パスを指定する必要はありません。

    たとえば、パスをに保存すると BITRISEIO_MY_FILE_LOCAL_PATH Env Varは、入力のパスとして使用でき、後続のすべてのステップでファイルにアクセスするためにも使用できます。

  5. クリック 保存する 右上隅にあります。

  1. アプリを開きます bitrise.yml ファイル。

  2. を追加します。 file-downloader ワークフローに進みます。

    workflows:
      download:
        steps:
        - activate-ssh-key: {}
        - git-clone: {}
        - file-downloader:
            inputs:
    
  3. の中に source 入力に、ファイルが見つかる場所を追加します。

    workflows:
      download:
        steps:
        - activate-ssh-key: {}
        - git-clone: {}
        - file-downloader:
            inputs:
            - source: "$BITRISEIO_BITRISE_TEST_URL"
    
  4. の中に destination 入力で、ファイルをダウンロードするパスを指定します。これは、リポジトリのルートに対する相対パスである必要があります。

    workflows:
      download:
        steps:
        - activate-ssh-key: {}
        - git-clone: {}
        - file-downloader:
            inputs:
            - destination: "/"
            - source: "$BITRISEIO_BITRISE_TEST_URL"
        - deploy-to-bitrise-io: {}

    入力値としてEnvVarを使用する

    入力に直接指定する代わりに、ファイルパスをApp EnvVarに保存できます。そうすれば、他のステップでEnv Varを介してファイルを参照できるため、毎回パスを指定する必要はありません。

    たとえば、パスをに保存すると BITRISEIO_MY_FILE_LOCAL_PATH Env Varは、入力のパスとして使用でき、後続のすべてのステップでファイルにアクセスするためにも使用できます。

カスタムスクリプトステップを使用してファイルをダウンロードする

使用したくない場合 ファイルダウンローダー ビルドでアップロードされたファイルをダウンロードしてアクセスするステップ。独自のカスタムスクリプトステップを使用することもできます。ダウンロードURLを取得し、ビルドマシンに存在する完全なダウンロードパスを指定してファイルをダウンロードするだけです。

ワークフローエディター

ビットライズ.yml

  1. でアプリを開きます ビットライズ

  2. クリック ワークフロー メインページのボタン。

  3. ワークフローとパイプライン ページで、必要なワークフローを見つけます。

    workflow-and-pipelines.png
  4. クリック edit-webhook.svg ワークフロー名の横にあるボタンをクリックします。

  5. 追加する 脚本 ワークフローに進みます。

  6. を見つける スクリプトの内容 ステップの入力。

  7. ファイルをダウンロードし、宛先パスを環境変数に保存するスクリプトを追加します。

    ファイルをBitriseにアップロードする

    もし、あんたが ファイルをBitriseにアップロードする、スクリプトでファイルのダウンロード URL を使用できます。

    以下の例では、ダウンロード URL は BITRISE_IO_MY_FILE_ID_URL 環境変数。私たちが使っているのは エンヴマン 宛先パスを BITRISEIO_MY_FILE_LOCAL_PATH 環境変数。後続のステップでは、この環境変数を使用してファイルにアクセスできます。

    #!/bin/bash
    set -ex
    
    # specify local download path
    export file_local_path=download/path/to/my/file
    
    # download the file
    wget -O "$file_local_path" "$BITRISEIO_MY_FILE_ID_URL"
    echo "file downloaded to: $file_local_path"
    
    # OPTIONALLY: export the file's local path, to be able to use it in subsequent steps as an input value
    envman add --key BITRISEIO_MY_FILE_LOCAL_PATH --value "$file_local_path"

    または、たとえば、場所をApp Env Varとして設定し、スクリプトステップ内でパスを定義する代わりに、そのパスにダウンロードすることもできます。

  1. を開きます。 bitrise.yml アプリのファイル。

  2. 追加 script ワークフローに進みます。

    my-workflow:
      steps:
        script:
          inputs:
          - content:
  3. の中に content 入力したら、ファイルをダウンロードし、宛先パスを環境変数に保存するスクリプトを追加します。

    ファイルをBitriseにアップロードする

    もし、あんたが ファイルをBitriseにアップロードする、スクリプト内でファイルのダウンロード URL を使用できます。

    以下の例では、ダウンロード URL は BITRISE_IO_MY_FILE_ID_URL 環境変数。私たちが使っているのは エンヴマン 宛先パスを BITRISEIO_MY_FILE_LOCAL_PATH 環境変数。後続のステップでは、この環境変数を使用してファイルにアクセスできます。

    my-workflow:
      steps:
        - script:
            inputs:
            - content:
            #!/bin/bash
            set -ex
    
            # specify local download path
            export file_local_path=download/path/to/my/file
    
            # download the file
            wget -O "$file_local_path" "$BITRISEIO_MY_FILE_ID_URL"
            echo "file downloaded to: $file_local_path"
    

    あるいは、たとえば、スクリプト ステップ内でパスを定義する代わりに、場所をアプリ環境変数として設定し、単純にそのパスにダウンロードすることもできます。

  4. 必要に応じて、ファイルのローカル パスをエクスポートして、同じワークフローの後続のステップで使用できるようにします。

    my-workflow:
      steps:
        - script:
            inputs:
            - content:
            #!/bin/bash
            set -ex
    
            # specify local download path
            export file_local_path=download/path/to/my/file
    
            # download the file
            wget -O "$file_local_path" "$BITRISEIO_MY_FILE_ID_URL"
            echo "file downloaded to: $file_local_path"
    
            # export the file path for subsequent steps
            envman add --key BITRISEIO_MY_FILE_LOCAL_PATH --value "$file_local_path"