(Các) số phiên bản / phiên bản ứng dụng iOS nào PHẢI được tăng lên khi phát hành App Store?

Các trường phiên bản / bản dựng cho ứng dụng iOS bao gồm:

• "Phiên bản" CFBundleShortVersionString (Chuỗi - iOS, OS X) chỉ định số phiên bản phát hành của gói, xác định phiên bản đã phát hành của ứng dụng. Số phiên bản phát hành là một chuỗi bao gồm ba số nguyên được phân tách bằng dấu chấm.

• "Build" CFBundleVersion (String - iOS, OS X) chỉ định số phiên bản xây dựng của gói, xác định số lần lặp lại (đã phát hành hoặc chưa phát hành) của gói. Số phiên bản xây dựng phải là một chuỗi bao gồm ba số nguyên không âm, được phân tách bằng dấu chấm với số nguyên đầu tiên lớn hơn 0. Chuỗi chỉ nên chứa các ký tự số (0-9) và dấu chấm (.). Các số không ở đầu được cắt bớt từ mỗi số nguyên và sẽ bị bỏ qua (nghĩa là 1.02.3 tương đương với 1.2.3). Khóa này không thể bản địa hóa.

• "Số phiên bản kết nối iTunes" : số phiên bản bạn chỉ định khi tạo phiên bản mới của ứng dụng trên iTunes Connect.

Câu hỏi của tôi là:

Số phiên bản / phiên bản nào được yêu cầu tăng lên khi một phiên bản mới của ứng dụng được tải lên iTunes Connect và / hoặc được phát hành lên App Store?

"Phiên bản" CFBundleShortVersionStringhoặc "bản dựng" có thể CFBundleVersiongiữ nguyên giữa các bản cập nhật ứng dụng không?

Điểm bổ sung cho các nguồn Apple hoặc thông báo lỗi chính xác iTunesConnect hiển thị khi tải lên phiên bản / số bản dựng không hợp lệ.

Ghi chú trên Android / Google Play:

Cuộc thảo luận đặt ra câu hỏi này là "phiên bản" công khai của ứng dụng Android trong Cửa hàng Google Play không cần phải tăng lên và không có cách nào được xác thực. Có android:versionNamethể giữ nguyên giữa các lần phát hành, nâng cấp, hạ cấp hoặc là bất kỳ chuỗi ngẫu nhiên nào chứ không phải là một cái gì đó có vẻ là "số phiên bản" hợp lệ.

android:versionName - Giá trị chuỗi đại diện cho phiên bản phát hành của mã ứng dụng, vì nó sẽ được hiển thị cho người dùng.

Giá trị là một chuỗi để bạn có thể mô tả phiên bản ứng dụng dưới dạng <major>.<minor>.<point>chuỗi hoặc dưới dạng bất kỳ loại mã định danh phiên bản tương đối hoặc tuyệt đối nào khác .

Sự khác biệt giữa versionName và versionNumber trong Android

Trong khi số android:versionCodenày được thực thi là một số nguyên tăng dần khi phát hành.

Tài liệu của Apple

Như đã lưu ý trong câu trả lời mới được chấp nhận , Apple gần đây đã xuất bản một Ghi chú kỹ thuật nêu chi tiết về phiên bản và lược đồ số bản dựng của họ:

Ghi chú kỹ thuật của Apple TN2420 - Số phiên bản và Số bản dựng

Ghi chú kỹ thuật của Apple TN2420, Số phiên bản và Số bản dựng

Tóm lược:

• Cặp ( Version, Build number) phải là duy nhất.
  • Chuỗi hợp lệ: (1.0.1, 12) -> (1.0.1, 13) -> (1.0.2, 13) -> (1.0.2, 14) ...
• Version( CFBundleShortVersionString ) phải theo thứ tự tuần tự tăng dần.
• Build number( CFBundleVersion ) phải theo thứ tự tuần tự tăng dần.

Danh sách kiểm tra số phiên bản và số bản dựng

Dưới đây là một số điều bạn có thể kiểm tra khi gửi bản dựng mới cho App Store. Đảm bảo rằng bạn đã đặt Số phiên bản và Số bản dựng đúng cách sẽ giúp bạn tránh việc Ứng dụng của bạn tự động bị từ chối do cấu hình chúng không đúng cách.

1. Đối với mỗi phiên bản mới của Ứng dụng, bạn cần phải tạo một Số phiên bản mới. Số này phải là một giá trị lớn hơn Số phiên bản cuối cùng mà bạn đã sử dụng. Mặc dù bạn có thể cung cấp nhiều bản dựng cho bất kỳ bản phát hành cụ thể nào của Ứng dụng, nhưng bạn chỉ cần sử dụng một Số phiên bản mới cho mỗi bản phát hành mới của Ứng dụng.
2. Bạn không thể sử dụng lại Số phiên bản.
3. Đối với mỗi bản dựng mới mà bạn gửi, bạn sẽ cần phải phát minh Số bản dựng mới có giá trị lớn hơn Số bản dựng cuối cùng bạn đã sử dụng (cho cùng phiên bản đó).
4. Bạn có thể sử dụng lại Số bản dựng trong các đợt phát hành khác nhau, nhưng bạn không thể sử dụng lại Số bản dựng trong cùng một đợt phát hành. Đối với ứng dụng macOS, bạn không thể sử dụng lại số bản dựng trong bất kỳ đợt phát hành nào.

Dựa trên danh sách kiểm tra, (Version, Build Number)trình tự sau đây cũng hợp lệ.

• Trường hợp: tái sử dụng Build Numbertrong các chuyến tàu phát hành khác nhau. (LƯU Ý: KHÔNG ứng dụng macOS)

  (1.0.0, 1) -> (1.0.0, 2) -> ... -> (1.0.0, 11) -> ( 1.0.1 , 1 ) -> (1.0.1, 2)

Các CFBundleShortVersionStringphải phù hợp với số phiên bản bạn cung cấp cho iTunes Connect. Nó cũng là số phiên bản xuất hiện khi người dùng nhìn vào Ứng dụng của bạn trong App Store.

Số phiên bản được hiển thị trong cửa hàng và phiên bản đó phải khớp với số phiên bản bạn nhập sau trong iTunes Connect.

Nguồn

Các CFBundleVersionkhông được hiển thị trong App Store, nhưng được sử dụng bởi iTunes để xác định khi App của bạn đã được cập nhật.

Nếu bạn cập nhật chuỗi xây dựng, như được mô tả trong “Đặt số phiên bản và chuỗi xây dựng”, iTunes nhận ra rằng chuỗi xây dựng đã thay đổi và đồng bộ hóa đúng cách Gói ứng dụng iOS mới để kiểm tra thiết bị.

Nguồn

Trả lời câu hỏi của bạn cụ thể hơn ...

Số phiên bản / phiên bản nào được yêu cầu tăng lên khi một phiên bản mới của ứng dụng được tải lên cửa hàng ứng dụng?

Cả hai. Một được hiển thị trong App Store, cái còn lại được iTunes sử dụng để cập nhật Ứng dụng.

CFBundleShortVersionString hoặc CFBundleVersion có thể giữ nguyên giữa các bản cập nhật ứng dụng không?

Không. (Câu hỏi meta, trường hợp sử dụng sẽ là gì ở đây? Nếu bạn đã chỉnh sửa tải trọng theo bất kỳ cách nào, bản dựng sẽ khác và người dùng sẽ muốn biết về nó). Nếu thử, bạn sẽ thấy các thông báo lỗi như bên dưới:

Hay chúng được so sánh với số tương ứng trước đó để đảm bảo rằng một số lớn hơn được tải lên cùng với phiên bản mới của ứng dụng?

Đúng. Sử dụng tiêu chuẩn semver.org .

Các số CFBundleShortVersionString và CFBundleVersion có so sánh với nhau theo cách nào không?

Không.

CFBundleShortVersionString là "tên" công khai của phiên bản (ví dụ: "2.5" hoặc "3.8.1"). Bạn phải tăng nó ở mỗi lần phát hành .

CFBundleVersion là số bản dựng riêng . Nó không được nhìn thấy trên AppStore. Bạn phải tăng nó ở mỗi lần tải lên . Có nghĩa là nếu bạn từ chối một tệp nhị phân trước khi nó trực tuyến và bạn muốn tải lên một tệp nhị phân mới, nó sẽ có cùng một CFBundleShortVersionString nhưng phải có CFBundleVersion cao hơn (ví dụ: public "2.5", private "2.5", và sau đó từ chối nhị phân và tải lên lại "2.5.1" riêng tư)

Chỉnh sửa vào ngày 16 tháng 11 năm 2016:

/ ! \ Thuộc tính CFBundleVersion cũng được sử dụng (cùng với CFBundleName ) trong User-Agenttiêu đề do NSURLConnection gửi trong mã của bạn.

Ví dụ: nếu CFBundleName là MyApp và CFBundleVersion là 2,21, thì bất kỳ truy vấn HTTP có lập trình nào được gửi trực tiếp bằng mã của bạn bằng NSURLConnection sẽ nhúng tiêu đề:

User-Agent: MyApp/2.21 CFNetwork/... Darwin/...

(Điều này không áp dụng cho các yêu cầu do UIWebView đưa ra tự động).

CFBundleVersion và CFBundleShortVersionString phải lớn hơn số phiên bản cuối cùng của ứng dụng. Đó là một thực hành tốt để giữ chúng giống nhau. Bạn sẽ tìm thấy chúng trong -info.plist của bạn.

Khi bạn cố gắng xác thực ứng dụng trong trình tổ chức, nó sẽ xuất hiện lỗi nếu một trong số chúng chưa được tăng dần. Đã xảy ra với tôi đêm qua.

Cả hai CFBundleVersionvà CFBundleShortVersionString PHẢI được tăng lên khi phát hành phiên bản mới cho App Store.

Ngoài ra, một trong các chuỗi phải khớp với phiên bản được chỉ định trong iTunes Connect.

Câu hỏi này bao gồm ảnh chụp màn hình ở trên về Trình xác thực của Công cụ tổ chức Xcode từ chối xác thực ứng dụng khi CFBundleVersionvà CFBundleShortVersionStringchưa được tăng lên.

• Gói này không hợp lệ. Giá trị cho khóa CFBundleVersion[1.0] trong tệp Info.plist phải chứa phiên bản cao hơn phiên bản đã tải lên trước đó [1.134].

• Gói này không hợp lệ. Giá trị cho khóa CFBundleShortVersionString[1.0] trong tệp Info.plist phải chứa phiên bản cao hơn phiên bản đã tải lên trước đó [1.134].

Trình xác thực cũng đưa ra lỗi chứng minh rằng một trong các chuỗi phải khớp với phiên bản của ứng dụng được tạo trên iTunes Connect.

• Phiên bản không phù hợp. Cả CFBundleVersion ['1.0'] và CFBundleShortVersionString ['1.0'] trong Info.plist đều không khớp với phiên bản của bộ ứng dụng trong iTunes Connect ['1.4'].

Ghi chú kỹ thuật hiện tại của Apple TN2420, Số phiên bản và Số bản dựng cho biết (in đậm của tôi):

4. Đối với ứng dụng iOS, bạn có thể sử dụng lại số bản dựng trong các đợt phát hành khác nhau, nhưng bạn không thể sử dụng lại số bản dựng trong cùng đợt phát hành. Đối với ứng dụng macOS, bạn không thể sử dụng lại số bản dựng trong bất kỳ đợt phát hành nào .

Thật không may, điều này có nghĩa là bạn không thể sử dụng lại số bản dựng theo dõi số chuyến tàu phát hành trên iOS khi bạn đang cố gắng phát hành bản dựng tương tự trên Mac Catalyst.

Ví dụ: trong trường hợp của tôi, do một số sự cố trước đó, tôi đã phát hành 1.0.2 (4) dưới dạng ứng dụng Mac Catalyst tương ứng với 1.0.2 (1) trên iOS. Hiện tại khi cố gắng phát hành 1.0.3 (1) trên cả hai, ứng dụng không xác minh được trên MacOS do số bản dựng, trong khi vượt qua xác minh trên iOS.

Tôi đoán bây giờ tôi đang phát hành cùng một ứng dụng trên cả iOS và MacOS thường xuyên, tôi sẽ áp dụng các số bản dựng tương ứng với ngày, như 20200111 và tăng dần bằng dấu thập phân nếu tôi cần thay đổi số bản dựng trong một bản phát hành nhất định.

Bạn cần phải tăng cả hai .

Khi tải lên phiên bản mới, bạn sẽ cần tạo một phiên bản mới trên iTunes Connect, phiên bản này tự động sẽ cao hơn các phiên bản trước. Phiên bản này trên iTunes Connect sẽ mong đợi một số nhị phân với cùng số phiên bản, do đó CFBundleShortVersionStringcần được tăng lên.

Nếu bạn cập nhật phiên bản nhưng quên tăng CFBundleVersion, bạn sẽ gặp lỗi trong quá trình tải lên. Xem câu trả lời và ảnh chụp màn hình của pkamb.

Để biết chi tiết về CFBundleShortVersionStringvà CFBundleVersion, vui lòng xem: https://stackoverflow.com/a/31921249/936957

Tôi có thể xác nhận rằng, tôi vừa thử theo cả hai cách, rằng một chuỗi phiên bản và số bản dựng như ...

1.0.0 (1)
1.0.1 (1)
1.0.2 (1)

... sẽ được chấp nhận cho các ứng dụng iOS, nhưng đối với các ứng dụng Mac (Catalyst), nó trả về lỗi này:

LỖI ITMS-90061: "Gói này không hợp lệ. Giá trị cho khóa CFBundleVersion [1] trong tệp Info.plist phải chứa phiên bản cao hơn phiên bản đã tải lên trước đó [2]."

Phiên bản Mac và số bản dựng sẽ cần phải giống như ...

1.0.0 (1)
1.0.1 (2)
1.0.2 (3)

Đối với iOS, tôi đã sử dụng để nhập số bản dựng làm số phiên bản cộng với chữ số thứ tư, như ...

1.0.0 (1.0.0.1)
1.0.1 (1.0.1.1)
1.0.2 (1.0.2.1)

... nhưng điều đó cũng không được phép đối với các ứng dụng Mac. Khi tôi thử gửi ứng dụng Mac (Catalyst) đầu tiên của mình, Apple sẽ chỉ chấp nhận số bản dựng có ba chữ số trở xuống:

LỖI ITMS-9000: "Gói này không hợp lệ. Giá trị cho khóa CFBundleVersion [1.0.0.1] trong tệp Info.plist phải là một danh sách được phân tách bằng dấu chấm của tối đa ba số nguyên không âm."

Vì vậy, tôi đã thay đổi thành một số duy nhất tăng dần cho mọi bản dựng và tiếp tục tăng trên các số phiên bản.

Tôi đang chuẩn bị phát hành một ứng dụng Mac App Store mới. Sử dụng định dạng CalVer của YEAR.release (build).

Tôi đã tải lên một vài xây dựng: 2020.0 (1), 2020.0 (2)vv Cuối cùng tôi gửi 2020.0 (8)cho App Store Review. Bài đánh giá đó đã được thông qua và ở trạng thái Đang chờ phát hành dành cho nhà phát triển .

Tôi muốn sửa chữa một vài điều trước khi phát hành, vì vậy tôi đã thêm một xây dựng mới để tàu phát hành cùng: 2020.0 (9).

Điều đó dẫn đến lỗi:

Lỗi hoạt động kết nối App Store

LỖI ITMS-90062 : "Gói này không hợp lệ. Giá trị cho khóa CFBundleShortVersionString[2020.0] trong tệp Info.plist phải chứa phiên bản cao hơn phiên bản đã được phê duyệt trước đó [2020.0]. Vui lòng tìm thêm thông tin CFBundleShortVersionStringtại https: // developer.apple.com/documentation/bundleresources/information_property_list/cfbundleshortversionstring "

điều này thật khó chịu vì 2020.0phiên bản của tôi chưa bao giờ thực sự được phát hành . Từ câu trả lời được chấp nhận của câu hỏi này, tôi có ấn tượng rằng cho đến khi ứng dụng có sẵn trên App Store, bạn có thể tiếp tục phát hành các bản dựng mới với cùng một phiên bản.

• Lỗi ITMS-90062: Giá trị cho khóa CFBundleShortVersionString phải chứa phiên bản cao hơn phiên bản đã được phê duyệt trước đó
• LỖI trình tải ứng dụng ITMS-90062: Giá trị cho khóa CFBundleShortVersionString phải chứa phiên bản cao hơn

Giải pháp dường như là không thể cập nhật "chuyến tàu phát hành" (Phiên bản tương tự + Bản dựng mới) nếu trạng thái ứng dụng là Bản phát hành dành cho nhà phát triển đang chờ xử lý . Phát hành bản dựng hiện có của bạn và sau đó tăng phiên bản hoặc Hủy bản phát hành này trong App Store Connect để cho phép tải lên thêm cho đợt phát hành này.

AFAIK, tôi không biết, bạn chỉ cần tăng số bản dựng CFBundleVersion. Không nhất thiết phải tăng chuỗi phiên bản ngắn, mặc dù bạn có thể nên tăng nó, vì nó cho người dùng biết rằng ứng dụng là mới. Tuy nhiên, Apple nói rằng việc đánh số phải tuân theo các quy ước lập phiên bản phần mềm truyền thống và iTunes Connect có thể phàn nàn nếu bạn cố tải lên lại một phiên bản đã có.

Truyện dài ngắn, nó có thể hiệu quả, nhưng có lẽ không.