@momo-kits/native-kits 0.156.1-test.7-debug → 0.156.1-test.8-debug

package/PUBLISH_GUIDE.md

@@ -0,0 +1,318 @@
+# Hướng Dẫn Publish NPM Package
+
+Tài liệu này hướng dẫn cách sử dụng các script publish beta và release cho `@momo-kits/native-kits`.
+
+---
+
+## 📋 Tổng Quan
+
+Dự án có 2 script publish chính:
+
+- **`publish_beta.sh`**: Publish phiên bản beta cho testing
+- **`publish_release.sh`**: Publish phiên bản release chính thức
+
+---
+
+## 🔵 Publish Beta
+
+### Khi Nào Sử Dụng?
+
+- Khi cần test tính năng mới
+- Khi phát triển feature chưa hoàn thiện
+- Khi cần chia sẻ build cho team testing
+
+### Cách Sử Dụng
+
+#### **Phương pháp 1: Manual**
+
+```bash
+sh publish_beta.sh
+```
+
+#### **Phương pháp 2: GitLab CI (Tự động)**
+
+Commit code với message chứa `[ci build]`:
+
+```bash
+git commit -m "feat: add new feature [ci build]"
+git push
+```
+
+### Cách Hoạt Động
+
+1. **Đọc version từ `package.json`**
+2. **Publish 2 phiên bản:**
+   - **Normal version**: Không bao gồm `compose/` (cho React Native)
+   - **Debug version**: Bao gồm `compose/` với suffix `-debug`
+
+### Ví Dụ
+
+**Trước publish:** `package.json` có `"version": "0.156.1"`
+
+**Output:**
+```
+📦 Version from package.json: 0.156.1
+📤 Publishing normal version (without compose)...
+✅ Normal version published successfully!
+
+📦 Debug version: 0.156.1-debug
+📤 Publishing debug version (with compose)...
+✅ Publishing completed successfully!
+```
+
+**Kết quả trên NPM:**
+- `@momo-kits/native-kits@0.156.1` (tag: beta)
+- `@momo-kits/native-kits@0.156.1-debug` (tag: beta)
+
+---
+
+## 🟢 Publish Release
+
+### Khi Nào Sử Dụng?
+
+- Khi merge code vào nhánh `main`
+- Khi release phiên bản production
+- Khi có version ổn định cần publish cho user
+
+### Cách Sử Dụng
+
+#### **Phương pháp 1: Manual**
+
+```bash
+sh publish_release.sh
+```
+
+#### **Phương pháp 2: GitLab CI (Tự động)**
+
+Merge code vào nhánh `main`:
+
+```bash
+git checkout main
+git merge develop
+git push origin main
+```
+
+### Cách Hoạt Động
+
+1. **Đọc version từ `package.json`**
+2. **Chuẩn hóa version về format beta:**
+   - Nếu có suffix không phải `-beta.*` (ví dụ: `-test.5`, `-alpha.2`) → convert sang `-beta.1`
+   - Nếu đã là `-beta.*` → giữ nguyên
+3. **Kiểm tra version trên NPM:**
+   - Nếu version đã tồn tại → tự động tăng beta number
+   - Lặp lại cho đến khi tìm được version chưa tồn tại
+4. **Publish với tag `latest`**
+
+### Ví Dụ Chi Tiết
+
+#### **Ví dụ 1: Version test được convert sang beta**
+
+**Trước publish:** `package.json` có `"version": "0.156.1-test.5"`
+
+**Output:**
+```
+📦 Version from package.json: 0.156.1-test.5
+🔄 Converting to beta format: 0.156.1-test.5 → 0.156.1-beta.1
+✅ Version updated to beta format: 0.156.1-beta.1
+🔎 Checking if version 0.156.1-beta.1 already exists on npm...
+⚠️  Version 0.156.1-beta.1 already exists on npm. Auto-incrementing version...
+   Version incremented: 0.156.1-beta.1 → 0.156.1-beta.2
+🔄 Checking version 0.156.1-beta.2 on npm...
+✅ Version 0.156.1-beta.2 does not exist on npm. Using this version.
+📤 Publishing...
+```
+
+**Kết quả:**
+- Publish `@momo-kits/native-kits@0.156.1-beta.2` (tag: latest)
+
+---
+
+#### **Ví dụ 2: Beta version tồn tại, tự động increment nhiều lần**
+
+**Trước publish:** `package.json` có `"version": "0.156.1-beta.5"`
+
+**Giả sử trên NPM đã có:**
+- `0.156.1-beta.5` ✓
+- `0.156.1-beta.6` ✓
+- `0.156.1-beta.7` ✓
+
+**Output:**
+```
+📦 Version from package.json: 0.156.1-beta.5
+🔎 Checking if version 0.156.1-beta.5 already exists on npm...
+⚠️  Version 0.156.1-beta.5 already exists on npm. Auto-incrementing version...
+   Version incremented: 0.156.1-beta.5 → 0.156.1-beta.6
+🔄 Checking version 0.156.1-beta.6 on npm...
+⚠️  Version 0.156.1-beta.6 already exists on npm. Auto-incrementing version...
+   Version incremented: 0.156.1-beta.6 → 0.156.1-beta.7
+🔄 Checking version 0.156.1-beta.7 on npm...
+⚠️  Version 0.156.1-beta.7 already exists on npm. Auto-incrementing version...
+   Version incremented: 0.156.1-beta.7 → 0.156.1-beta.8
+🔄 Checking version 0.156.1-beta.8 on npm...
+✅ Version 0.156.1-beta.8 does not exist on npm. Using this version.
+```
+
+**Kết quả:**
+- Publish `@momo-kits/native-kits@0.156.1-beta.8` (tag: latest)
+
+---
+
+#### **Ví dụ 3: Version mới, không cần increment**
+
+**Trước publish:** `package.json` có `"version": "0.157.0-beta.1"`
+
+**Output:**
+```
+📦 Version from package.json: 0.157.0-beta.1
+🔎 Checking if version 0.157.0-beta.1 already exists on npm...
+✅ Version 0.157.0-beta.1 does not exist on npm. Using this version.
+```
+
+**Kết quả:**
+- Publish `@momo-kits/native-kits@0.157.0-beta.1` (tag: latest)
+
+---
+
+#### **Ví dụ 4: Version không có suffix**
+
+**Trước publish:** `package.json` có `"version": "1.0.0"`
+
+**Output:**
+```
+📦 Version from package.json: 1.0.0
+🔎 Checking if version 1.0.0 already exists on npm...
+⚠️  Version 1.0.0 already exists on npm. Auto-incrementing version...
+   Version incremented: 1.0.0 → 1.0.1
+🔄 Checking version 1.0.1 on npm...
+✅ Version 1.0.1 does not exist on npm. Using this version.
+```
+
+**Kết quả:**
+- Publish `@momo-kits/native-kits@1.0.1` (tag: latest)
+
+---
+
+## 📊 So Sánh Publish Beta vs Release
+
+| Tiêu chí | Publish Beta | Publish Release |
+|----------|--------------|-----------------|
+| **Script** | `publish_beta.sh` | `publish_release.sh` |
+| **Trigger CI** | Commit message có `[ci build]` | Merge vào `main` |
+| **NPM Tag** | `beta` | `latest` |
+| **Version Check** | Không | Có (tự động increment) |
+| **Format Version** | Giữ nguyên | Chuẩn hóa sang `-beta.*` |
+| **Số phiên bản publish** | 2 (normal + debug) | 1 (chỉ normal) |
+
+---
+
+## 🔧 Workflow Khuyến Nghị
+
+### Development Flow
+
+```mermaid
+graph LR
+    A[Develop Feature] --> B[Update version in package.json]
+    B --> C{Ready for testing?}
+    C -->|Yes| D[Commit với message ci build]
+    D --> E[publish_beta.sh chạy tự động]
+    E --> F[Team test version beta]
+    F --> G{Approved?}
+    G -->|No| A
+    G -->|Yes| H[Merge to main]
+    H --> I[publish_release.sh chạy tự động]
+    I --> J[Version release published]
+```
+
+### Bước Thực Hiện
+
+1. **Development:**
+   ```bash
+   # Update version trong package.json
+   # Ví dụ: "version": "0.156.2-test.1"
+   ```
+
+2. **Beta Testing:**
+   ```bash
+   git add .
+   git commit -m "feat: add new component [ci build]"
+   git push
+   # → Tự động publish beta
+   ```
+
+3. **Release Production:**
+   ```bash
+   git checkout main
+   git merge develop
+   git push origin main
+   # → Tự động publish release với version được chuẩn hóa
+   ```
+
+---
+
+## ⚠️ Lưu Ý Quan Trọng
+
+### 1. Format Version
+
+- **Beta script**: Chấp nhận mọi format version
+- **Release script**: Tự động chuẩn hóa sang format `-beta.*`
+  - `0.156.1-test.5` → `0.156.1-beta.1`
+  - `0.156.1-alpha.2` → `0.156.1-beta.1`
+  - `0.156.1-rc.3` → `0.156.1-beta.1`
+
+### 2. Auto-Increment
+
+Script release có logic tự động tăng version:
+- **Beta versions**: Tăng beta number (`-beta.5` → `-beta.6`)
+- **Regular versions**: Tăng patch number (`1.0.0` → `1.0.1`)
+
+### 3. File Modifications
+
+Cả 2 script đều tạm thời modify các file sau (và restore lại sau khi publish):
+- `package.json` (version)
+- `gradle.properties` (version)
+- `.npmignore` (cho debug version)
+- `compose/build.gradle.kts` (cho debug version)
+
+### 4. Requirements
+
+Cần có quyền publish package trên NPM:
+```bash
+# Login NPM trước khi chạy manual
+npm login
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Lỗi: "Could not read version from package.json"
+
+**Nguyên nhân:** File `package.json` không hợp lệ hoặc không có field `version`
+
+**Giải pháp:**
+```bash
+# Kiểm tra package.json
+cat package.json | grep version
+```
+
+### Lỗi: "Version already exists on npm"
+
+**Nguyên nhân:** Chỉ với beta script - version đã được publish
+
+**Giải pháp:** 
+- Tăng version trong `package.json` manually
+- Hoặc sử dụng release script (sẽ tự động increment)
+
+### Script không chạy trên GitLab CI
+
+**Nguyên nhân:** Không đủ điều kiện trigger
+
+**Giải pháp:**
+- Beta: Đảm bảo commit message có `[ci build]`
+- Release: Đảm bảo đang push vào nhánh `main`
+
+---
+
+## 📞 Support
+
+Nếu có vấn đề, liên hệ team hoặc tạo issue trên GitLab.

package/compose/build.gradle.kts

@@ -40,7 +40,7 @@ kotlin {
     }
 
     cocoapods {
-        version = "0.156.1-test.7-debug"
+        version = "0.156.1-test.8-debug"
         summary = "IOS Shared module"
         homepage = "https://momo.vn"
         ios.deploymentTarget = "15.0"

package/gradle.properties

@@ -18,7 +18,7 @@ kotlin.apple.xcodeCompatibility.nowarn=true
 name="ComposeKits"
 group=vn.momo.kits
 artifact.id=kits
-version=0.156.1-test.7
+version=0.156.1-test.8
 
 repo=GitLab
 url=https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@momo-kits/native-kits",
-  "version": "0.156.1-test.7-debug",
+  "version": "0.156.1-test.8-debug",
   "private": false,
   "dependencies": {},
   "devDependencies": {},