Có thể tạo biến chuỗi nhiều dòng trong Makefile không

Tôi muốn tạo một biến makefile là một chuỗi nhiều dòng (ví dụ: phần nội dung của thông báo phát hành email). cái gì đó như

ANNOUNCE_BODY="
Version $(VERSION) of $(PACKAGE_NAME) has been released

It can be downloaded from $(DOWNLOAD_URL)

etc, etc"

Nhưng tôi dường như không thể tìm ra cách để làm điều này. Có khả thi không?

Có, bạn có thể sử dụng từ khóa xác định để khai báo một biến nhiều dòng, như sau:

define ANNOUNCE_BODY
Version $(VERSION) of $(PACKAGE_NAME) has been released.

It can be downloaded from $(DOWNLOAD_URL).

etc, etc.
endef

Phần khó khăn là đưa biến nhiều dòng của bạn trở lại khỏi makefile. Nếu bạn chỉ làm điều hiển nhiên là sử dụng "echo $ (ANNOUNCE_BODY)", bạn sẽ thấy kết quả mà những người khác đã đăng ở đây - shell cố gắng xử lý các dòng thứ hai và tiếp theo của biến dưới dạng các lệnh.

Tuy nhiên, bạn có thể xuất giá trị biến nguyên trạng sang shell dưới dạng một biến môi trường, rồi tham chiếu nó từ shell dưới dạng một biến môi trường (KHÔNG PHẢI là biến make). Ví dụ:

export ANNOUNCE_BODY
all:
    @echo "$$ANNOUNCE_BODY"

Lưu ý việc sử dụng $$ANNOUNCE_BODY, chỉ ra một tham chiếu biến môi trường shell, thay vì $(ANNOUNCE_BODY), sẽ là một tham chiếu biến make thông thường. Ngoài ra, hãy đảm bảo sử dụng dấu ngoặc kép xung quanh tham chiếu biến của bạn, để đảm bảo rằng các dòng mới không được diễn giải bởi chính shell.

Tất nhiên, thủ thuật cụ thể này có thể nhạy cảm với nền tảng và vỏ. Tôi đã thử nghiệm nó trên Ubuntu Linux với GNU bash 3.2.13; YMMV.

Một cách tiếp cận khác để 'đưa biến nhiều dòng của bạn trở lại makefile' (được Eric Melski lưu ý là 'phần khó'), là lập kế hoạch sử dụng substhàm để thay thế các dòng mới được giới thiệu definetrong chuỗi nhiều dòng của bạn với \n. Sau đó, sử dụng -e with echođể giải thích chúng. Bạn có thể cần đặt .SHELL = bash để nhận được tiếng vọng thực hiện điều này.

Một lợi thế của cách tiếp cận này là bạn cũng đưa các ký tự thoát khác như vậy vào văn bản của mình và được chúng tôn trọng.

Loại tổng hợp này tổng hợp tất cả các phương pháp được đề cập cho đến nay ...

Bạn kết thúc với:

define newline


endef

define ANNOUNCE_BODY=
As of $(shell date), version $(VERSION) of $(PACKAGE_NAME) has been released.  

It can be downloaded from $(DOWNLOAD_URL).  

endef

someTarget:
    echo -e '$(subst $(newline),\n,${ANNOUNCE_BODY})'

Lưu ý rằng các dấu ngoặc kép về tiếng vọng cuối cùng là rất quan trọng.

Giả sử bạn chỉ muốn in nội dung của biến của mình trên đầu ra chuẩn, có một giải pháp khác:

do-echo:
    $(info $(YOUR_MULTILINE_VAR))

Đúng. Bạn thoát khỏi dòng mới với \:

VARIABLE="\
THIS IS A VERY LONG\
TEXT STRING IN A MAKE VARIABLE"

cập nhật

Ah, bạn muốn dòng mới? Vậy thì không, tôi không nghĩ có cách nào trong vani Make. Tuy nhiên, bạn luôn có thể sử dụng tài liệu tại đây trong phần lệnh

[Điều này không hiệu quả, hãy xem bình luận từ MadScientist]

foo:
    echo <<EOF
    Here is a multiple line text
    with embedded newlines.
    EOF

Chỉ là một phần tái bút cho câu trả lời của Eric Melski: Bạn có thể bao gồm đầu ra của các lệnh trong văn bản, nhưng bạn phải sử dụng cú pháp Makefile "$ (shell foo)" thay vì cú pháp shell "$ (foo)". Ví dụ:

define ANNOUNCE_BODY  
As of $(shell date), version $(VERSION) of $(PACKAGE_NAME) has been released.  

It can be downloaded from $(DOWNLOAD_URL).  

endef

Điều này không cung cấp một tài liệu ở đây, nhưng nó hiển thị một thông báo nhiều dòng theo cách phù hợp với đường ống.

=====

MSG = this is a\\n\
multi-line\\n\
message

method1:
     @$(SHELL) -c "echo '$(MSG)'" | sed -e 's/^ //'

=====

Bạn cũng có thể sử dụng các macro có thể gọi của Gnu:

=====

MSG = this is a\\n\
multi-line\\n\
message

method1:
        @echo "Method 1:"
        @$(SHELL) -c "echo '$(MSG)'" | sed -e 's/^ //'
        @echo "---"

SHOW = $(SHELL) -c "echo '$1'" | sed -e 's/^ //'

method2:
        @echo "Method 2:"
        @$(call SHOW,$(MSG))
        @echo "---"

=====

Đây là kết quả:

=====

$ make method1 method2
Method 1:
this is a
multi-line
message
---
Method 2:
this is a
multi-line
message
---
$

=====

Tại sao bạn không sử dụng ký tự \ n trong chuỗi của mình để xác định phần cuối của dòng? Cũng thêm dấu gạch chéo ngược bổ sung để thêm nó trên nhiều dòng.

ANNOUNCE_BODY=" \n\
Version $(VERSION) of $(PACKAGE_NAME) has been released \n\
\n\
It can be downloaded from $(DOWNLOAD_URL) \n\
\n\
etc, etc"

Sổ tay GNU `make '', 6.8: Định nghĩa các biến nhiều dòng

Bạn nên sử dụng "xác định / endef" Tạo cấu trúc:

define ANNOUNCE_BODY
Version $(VERSION) of $(PACKAGE_NAME) has been released.

It can be downloaded from $(DOWNLOAD_URL).

etc, etc.
endef

Sau đó, bạn nên chuyển giá trị của biến này vào lệnh shell. Tuy nhiên, nếu bạn làm điều này bằng cách sử dụng Thực hiện thay thế biến, nó sẽ khiến lệnh bị chia thành nhiều:

ANNOUNCE.txt:
  echo $(ANNOUNCE_BODY) > $@               # doesn't work

Qouting cũng không giúp được gì.

Cách tốt nhất để chuyển giá trị là chuyển nó qua biến môi trường:

ANNOUNCE.txt: export ANNOUNCE_BODY:=$(ANNOUNCE_BODY)
ANNOUNCE.txt:
  echo "$${ANNOUNCE_BODY}" > $@

Để ý:

1. Biến được xuất cho mục tiêu cụ thể này, để bạn có thể tái sử dụng môi trường đó sẽ không bị ô nhiễm nhiều;
2. Sử dụng biến môi trường (qoutes kép và dấu ngoặc nhọn xung quanh tên biến);
3. Sử dụng các dấu ngoặc kép xung quanh biến. Nếu không có chúng, các dòng mới sẽ bị mất và tất cả văn bản sẽ xuất hiện trên một dòng.

Với tinh thần .ONESHELL, bạn có thể tiến khá gần trong các môi trường đầy thử thách .ONESHELL:

define _oneshell_newline_


endef

define oneshell
@eval "$$(printf '%s\n' '$(strip                            \
                         $(subst $(_oneshell_newline_),\n,  \
                         $(subst \,\/,                      \
                         $(subst /,//,                      \
                         $(subst ','"'"',$(1))))))' |       \
          sed -e 's,\\n,\n,g' -e 's,\\/,\\,g' -e 's,//,/,g')"
endef

Một ví dụ về việc sử dụng sẽ như thế này:

define TEST
printf '>\n%s\n' "Hello
World\n/$$$$/"
endef

all:
        $(call oneshell,$(TEST))

Điều đó cho thấy đầu ra (giả sử pid 27801):

>
Hello
World\n/27801/

Cách tiếp cận này cho phép một số chức năng bổ sung:

define oneshell
@eval "set -eux ; $$(printf '%s\n' '$(strip                            \
                                    $(subst $(_oneshell_newline_),\n,  \
                                    $(subst \,\/,                      \
                                    $(subst /,//,                      \
                                    $(subst ','"'"',$(1))))))' |       \
                     sed -e 's,\\n,\n,g' -e 's,\\/,\\,g' -e 's,//,/,g')"
endef

Các tùy chọn shell này sẽ:

• In từng lệnh khi nó được thực thi
• Thoát khỏi lệnh đầu tiên bị lỗi
• Coi việc sử dụng các biến shell không xác định là một lỗi

Các khả năng thú vị khác có thể sẽ tự gợi ý.

Tôi thích câu trả lời của alhadis nhất. Nhưng để giữ định dạng cột, hãy thêm một điều nữa.

SYNOPSIS := :: Synopsis: Makefile\
| ::\
| :: Usage:\
| ::    make .......... : generates this message\
| ::    make synopsis . : generates this message\
| ::    make clean .... : eliminate unwanted intermediates and targets\
| ::    make all ...... : compile entire system from ground-up\
endef

Kết quả đầu ra:

:: Synopsis: Makefile 
:: 
:: Usage: 
:: make .......... : generates this message 
:: make synopsis . : generates this message 
:: make clean .... : eliminate unwanted intermediates and targets 
:: make all ...... : compile entire system from ground-up

Không hoàn toàn liên quan đến OP, nhưng hy vọng điều này sẽ giúp ích cho ai đó trong tương lai. (vì câu hỏi này là câu hỏi xuất hiện nhiều nhất trong các tìm kiếm của google).

Trong Makefile của mình, tôi muốn chuyển nội dung của một tệp đến lệnh xây dựng docker, sau nhiều lần băn khoăn, tôi quyết định:

 base64 encode the contents in the Makefile (so that I could have a single line and pass them as a docker build arg...)
 base64 decode the contents in the Dockerfile (and write them to a file)

xem ví dụ bên dưới.

nb: Trong trường hợp cụ thể của tôi, tôi muốn chuyển một khóa ssh, trong quá trình xây dựng hình ảnh, bằng cách sử dụng ví dụ từ https://vsupalov.com/build-docker-image-clone-private-repo-ssh-key/ (sử dụng một bản dựng docker nhiều giai đoạn để sao chép git repo, sau đó thả khóa ssh khỏi hình ảnh cuối cùng trong giai đoạn thứ 2 của bản dựng)

Makefile

...
MY_VAR_ENCODED=$(shell cat /path/to/my/file | base64)

my-build:
    @docker build \
      --build-arg MY_VAR_ENCODED="$(MY_VAR_ENCODED)" \
      --no-cache \
      -t my-docker:build .
...

Dockerfile

...
ARG MY_VAR_ENCODED

RUN mkdir /root/.ssh/  && \
    echo "${MY_VAR_ENCODED}" | base64 -d >  /path/to/my/file/in/container
... 

Với GNU Make 3.82 trở lên, .ONESHELLtùy chọn là người bạn của bạn khi nói đến các đoạn mã đa dòng. Tổng hợp các gợi ý từ các câu trả lời khác, tôi nhận được:

VERSION = 1.2.3
PACKAGE_NAME = foo-bar
DOWNLOAD_URL = $(PACKAGE_NAME).somewhere.net

define nwln

endef

define ANNOUNCE_BODY
Version $(VERSION) of $(PACKAGE_NAME) has been released.

It can be downloaded from $(DOWNLOAD_URL).

etc, etc.
endef

.ONESHELL:

# mind the *leading* <tab> character
version:
    @printf "$(subst $(nwln),\n,$(ANNOUNCE_BODY))"

Đảm bảo rằng khi sao chép và dán ví dụ trên vào trình chỉnh sửa của bạn, mọi <tab>ký tự đều được giữ nguyên, nếu khôngversion mục tiêu sẽ bị hỏng!

Lưu ý rằng điều đó .ONESHELLsẽ khiến tất cả các mục tiêu trong Makefile sử dụng một trình bao duy nhất cho tất cả các lệnh của chúng.

Không thực sự là một câu trả lời hữu ích, nhưng chỉ để chỉ ra rằng 'xác định' không hoạt động như câu trả lời của Axe (không phù hợp với một nhận xét):

VERSION=4.3.1
PACKAGE_NAME=foobar
DOWNLOAD_URL=www.foobar.com

define ANNOUNCE_BODY
    Version $(VERSION) of $(PACKAGE_NAME) has been released
    It can be downloaded from $(DOWNLOAD_URL)
    etc, etc
endef

all:
    @echo $(ANNOUNCE_BODY)

Nó đưa ra lỗi không thể tìm thấy lệnh 'Nó', vì vậy nó cố gắng diễn giải dòng thứ hai của ANNOUNCE BODY dưới dạng một lệnh.

Nó đã làm việc cho tôi:

ANNOUNCE_BODY="first line\\nsecond line"

all:
    @echo -e $(ANNOUNCE_BODY)

GNU Makefile có thể làm những việc như sau. Nó xấu xí, và tôi sẽ không nói bạn nên làm điều đó, nhưng tôi làm trong một số tình huống nhất định.

PROFILE = \
\#!/bin/sh.exe\n\
\#\n\
\# A MinGW equivalent for .bash_profile on Linux.  In MinGW/MSYS, the file\n\
\# is actually named .profile, not .bash_profile.\n\
\#\n\
\# Get the aliases and functions\n\
\#\n\
if [ -f \$${HOME}/.bashrc ]\n\
then\n\
  . \$${HOME}/.bashrc\n\
fi\n\
\n\
export CVS_RSH="ssh"\n  
#
.profile:
        echo -e "$(PROFILE)" | sed -e 's/^[ ]//' >.profile

make .profile tạo tệp .profile nếu tệp không tồn tại.

Giải pháp này đã được sử dụng khi ứng dụng sẽ chỉ sử dụng GNU Makefile trong môi trường shell POSIX. Dự án không phải là một dự án mã nguồn mở mà tính tương thích của nền tảng là một vấn đề.

Mục tiêu là tạo một Makefile hỗ trợ cả việc thiết lập và sử dụng một loại không gian làm việc cụ thể. Makefile mang đến cho nó nhiều tài nguyên đơn giản khác nhau mà không yêu cầu những thứ như một kho lưu trữ đặc biệt khác, v.v. Theo một nghĩa nào đó, nó là một kho lưu trữ shell. Sau đó, một thủ tục có thể nói những điều như thả Makefile này vào thư mục để làm việc. Thiết lập vùng làm việc của bạn enter make workspace, sau đó để làm blah, hãy entermake blah , v.v.

Điều có thể trở nên khó khăn là tìm ra những gì để bao gồm báo giá. Ở trên thực hiện công việc và gần với ý tưởng chỉ định một tài liệu tại đây trong Makefile. Cho dù đó là một ý tưởng tốt để sử dụng chung là một vấn đề hoàn toàn khác.

Tôi tin rằng câu trả lời an toàn nhất cho việc sử dụng đa nền tảng là sử dụng một tiếng vọng trên mỗi dòng:

  ANNOUNCE.txt:
    rm -f $@
    echo "Version $(VERSION) of $(PACKAGE_NAME) has been released" > $@
    echo "" >> $@
    echo "It can be downloaded from $(DOWNLOAD_URL)" >> $@
    echo >> $@
    echo etc, etc" >> $@

Điều này tránh đưa ra bất kỳ giả định nào về phiên bản tiếng vọng có sẵn.

Sử dụng thay thế chuỗi :

VERSION := 1.1.1
PACKAGE_NAME := Foo Bar
DOWNLOAD_URL := https://go.get/some/thing.tar.gz

ANNOUNCE_BODY := Version $(VERSION) of $(PACKAGE_NAME) has been released. \
    | \
    | It can be downloaded from $(DOWNLOAD_URL) \
    | \
    | etc, etc

Sau đó, trong công thức của bạn, hãy đặt

    @echo $(subst | ,$$'\n',$(ANNOUNCE_BODY))

Điều này hoạt động vì Make đang thay thế tất cả các lần xuất hiện của | (lưu ý dấu cách) và hoán đổi nó bằng một ký tự dòng mới ( $$'\n'). Bạn có thể nghĩ về các lời gọi shell-script tương đương như sau:

Trước:

$ echo "Version 1.1.1 of Foo Bar has been released. | | It can be downloaded from https://go.get/some/thing.tar.gz | | etc, etc"

Sau:

$ echo "Version 1.1.1 of Foo Bar has been released.
>
> It can be downloaded from https://go.get/some/thing.tar.gz
> 
> etc, etc"

Tôi không chắc liệu $'\n'có sẵn trên các hệ thống không phải POSIX hay không, nhưng nếu bạn có thể có quyền truy cập vào một ký tự dòng mới (thậm chí bằng cách đọc một chuỗi từ tệp bên ngoài), nguyên tắc cơ bản là giống nhau.

Nếu bạn có nhiều thông báo như thế này, bạn có thể giảm nhiễu bằng cách sử dụng macro :

print = $(subst | ,$$'\n',$(1))

Nơi bạn sẽ gọi nó như thế này:

@$(call print,$(ANNOUNCE_BODY))

Hy vọng điều này sẽ giúp ai đó. =)

Thay vào đó, bạn có thể sử dụng lệnh printf. Điều này hữu ích trên OSX hoặc các nền tảng khác có ít tính năng hơn.

Để đơn giản xuất một tin nhắn nhiều dòng:

all:
        @printf '%s\n' \
            'Version $(VERSION) has been released' \
            '' \
            'You can download from URL $(URL)'

Nếu bạn đang cố gắng chuyển chuỗi dưới dạng đối số cho một chương trình khác, bạn có thể làm như sau:

all:
        /some/command "`printf '%s\n' 'Version $(VERSION) has been released' '' 'You can download from URL $(URL)'`"