🔧 Installation Issues এবং সমাধান

FLX CLI installation সংক্রান্ত সমস্যা এবং তাদের সমাধান।

📥 Installation Problems

1. "Command not found: flx"

সমস্যা: Installation successful হওয়ার পরও flx command পাওয়া যাচ্ছে না।

সমাধান:

# PATH environment variable check করুন
echo $PATH

# Dart pub global bin directory check করুন
ls ~/.pub-cache/bin/

# PATH এ pub cache bin directory যোগ করুন
export PATH="$PATH":"$HOME/.pub-cache/bin"

# Permanent করার জন্য bash/zsh profile এ যোগ করুন
echo 'export PATH="$PATH":"$HOME/.pub-cache/bin"' >> ~/.bashrc
source ~/.bashrc

# macOS এর জন্য .zshrc
echo 'export PATH="$PATH":"$HOME/.pub-cache/bin"' >> ~/.zshrc
source ~/.zshrc

# Verify installation
flx --version

2. "Failed to install FLX"

সমস্যা: dart pub global activate flx_cli command fail হচ্ছে।

সমাধান:

# Dart SDK version check করুন (minimum 2.17.0)
dart --version

# Flutter SDK check করুন
flutter --version

# Pub cache clean করুন
dart pub cache clean

# Internet connection verify করুন
ping pub.dev

# Retry installation with verbose output
dart pub global activate flx_cli --verbose

# যদি pub.dev access issue হয়, proxy settings check করুন
dart pub global activate flx_cli --verbose --trace

3. "Permission denied"

সমস্যা: Installation এর সময় permission error।

সমাধান:

# Linux/macOS এর জন্য
sudo dart pub global activate flx_cli

# অথবা user-level installation
mkdir -p ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"
dart pub global activate flx_cli

# Directory permission fix করুন
chmod 755 ~/.pub-cache
chmod 755 ~/.pub-cache/bin

# Windows এর জন্য Administrator হিসেবে run করুন
# Run PowerShell/Command Prompt as Administrator

🖥️ Platform-specific Issues

Windows Issues

1. "Windows Defender blocking installation"

সমস্যা: Antivirus software FLX CLI block করছে।

সমাধান:

# Windows Defender exclusion add করুন
# Settings -> Update & Security -> Windows Security -> Virus & threat protection
# -> Manage settings -> Add or remove exclusions

# Exclusion paths:
# %USERPROFILE%\AppData\Local\Pub\Cache
# %USERPROFILE%\AppData\Local\Pub\Cache\bin

# PowerShell execution policy check করুন
Get-ExecutionPolicy

# Execution policy change করুন (if needed)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. "Path not updating on Windows"

সমস্যা: PATH environment variable update হচ্ছে না।

সমাধান:

# Environment Variables manually add করুন
# System Properties -> Advanced -> Environment Variables
# User variables -> PATH -> Edit -> New
# Add: %USERPROFILE%\AppData\Local\Pub\Cache\bin

# PowerShell থেকে temporary add করুন
$env:PATH += ";$env:USERPROFILE\AppData\Local\Pub\Cache\bin"

# Permanent add করার জন্য
[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User) + ";$env:USERPROFILE\AppData\Local\Pub\Cache\bin",
    [EnvironmentVariableTarget]::User
)

# Restart PowerShell/Command Prompt

3. "Long path names issue"

সমস্যা: Windows long path names support নেই।

সমাধান:

# Group Policy Editor (gpedit.msc) থেকে enable করুন
# Computer Configuration -> Administrative Templates 
# -> System -> Filesystem -> Enable Win32 long paths

# Registry থেকে enable করুন
reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v LongPathsEnabled /t REG_DWORD /d 1

# Git config করুন
git config --system core.longpaths true

macOS Issues

1. "macOS Gatekeeper blocking FLX"

সমস্যা: macOS Gatekeeper FLX CLI block করছে।

সমাধান:

# Allow apps from anywhere (temporary)
sudo spctl --master-disable

# Specific file allow করুন
sudo xattr -rd com.apple.quarantine ~/.pub-cache/bin/flx

# Re-enable Gatekeeper
sudo spctl --master-enable

# Homebrew থেকে Dart install করুন
brew install dart

# Verify installation
dart --version
flx --version

2. "Xcode Command Line Tools missing"

সমস্যা: Command line tools missing যা compilation এর জন্য দরকার।

সমাধান:

# Xcode Command Line Tools install করুন
xcode-select --install

# Verify installation
xcode-select --print-path

# License agree করুন
sudo xcodebuild -license accept

# Retry FLX installation
dart pub global activate flx

Linux Issues

1. "Dart SDK not found"

সমস্যা: Linux এ Dart SDK properly install হয়নি।

সমাধান:

# Official Dart repository add করুন
sudo apt update
sudo apt install apt-transport-https
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo 'deb https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list

# Dart SDK install করুন
sudo apt update
sudo apt install dart

# PATH add করুন
echo 'export PATH="$PATH:/usr/lib/dart/bin"' >> ~/.bashrc
source ~/.bashrc

# Verify installation
dart --version

2. "libstdc++ missing"

সমস্যা: Required libraries missing।

সমাধান:

# Ubuntu/Debian
sudo apt update
sudo apt install build-essential libstdc++6

# CentOS/RHEL/Fedora
sudo yum install gcc-c++ libstdc++
# অথবা
sudo dnf install gcc-c++ libstdc++

# Arch Linux
sudo pacman -S base-devel

# Verify libraries
ldd $(which dart)

🌐 Network Issues

1. "Unable to connect to pub.dev"

সমস্যা: Network connectivity issues।

সমাধান:

# Network connectivity test করুন
ping pub.dev
ping google.com

# DNS check করুন
nslookup pub.dev

# Alternative DNS ব্যবহার করুন
# Google DNS: 8.8.8.8, 8.8.4.4
# Cloudflare DNS: 1.1.1.1, 1.0.0.1

# Proxy settings check করুন (if applicable)
echo $HTTP_PROXY
echo $HTTPS_PROXY

# Pub cache clean এবং retry
dart pub cache clean
dart pub global activate flx

2. "Certificate verification failed"

সমস্যা: SSL certificate verification issues।

সমাধান:

# Certificate store update করুন
# Ubuntu/Debian
sudo apt update && sudo apt install ca-certificates

# macOS
brew update && brew install ca-certificates

# Manual certificate verification disable (not recommended)
export PUB_HOSTED_URL=http://pub.dartlang.org
dart pub global activate flx

# Git SSL verification disable (temporary)
git config --global http.sslVerify false

3. "Corporate firewall blocking"

সমস্যা: Corporate network firewall blocking pub.dev।

সমাধান:

# Proxy configuration
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Dart pub proxy configuration
dart pub config set HTTP_PROXY http://proxy.company.com:8080
dart pub config set HTTPS_PROXY http://proxy.company.com:8080

# Verify proxy settings
dart pub config

# Alternative: Manual download এবং install
# Download .tar.gz file manually এবং extract করুন

🔄 Version Issues

1. "Dart SDK version incompatible"

সমস্যা: Dart SDK version too old।

সমাধান:

# Current Dart version check করুন
dart --version

# Minimum required: Dart 2.17.0

# Dart SDK update করুন
# Flutter users:
flutter upgrade

# Standalone Dart:
# Download latest from https://dart.dev/get-dart

# Verify compatibility
dart --version
flutter --version

2. "FLX version conflict"

সমস্যা: Multiple versions installed বা version mismatch।

সমাধান:

# Current installed version check করুন
flx --version

# Uninstall existing version
dart pub global deactivate flx

# Clean pub cache
dart pub cache clean

# Install latest version
dart pub global activate flx

# Verify single installation
dart pub global list

3. "Flutter SDK conflict"

সমস্যা: Flutter SDK version incompatible।

সমাধান:

# Flutter version check করুন
flutter --version

# Flutter upgrade করুন
flutter upgrade

# Flutter doctor run করুন
flutter doctor

# Resolve any issues shown by flutter doctor

# Retry FLX installation
dart pub global activate flx

🧹 Clean Installation

Complete Cleanup and Reinstall

# 1. Uninstall existing FLX
dart pub global deactivate flx

# 2. Clean pub cache
dart pub cache clean

# 3. Remove pub cache directory (if necessary)
rm -rf ~/.pub-cache

# 4. Remove Flutter cache (if necessary)
flutter clean

# 5. Fresh installation
dart pub global activate flx

# 6. Verify installation
flx --version
flx --help

Verify Installation

# Check FLX version
flx --version

# Check installation path
which flx

# Test basic functionality
flx config

# Create test project এবং verify
mkdir test_flx && cd test_flx
flx gen feature test
ls -la lib/features/test/

🚀 Alternative Installation Methods

1. Git Installation (Development)

# Clone repository
git clone https://github.com/your-repo/flx.git
cd flx

# Install dependencies
dart pub get

# Activate from source
dart pub global activate --source path .

# Verify
flx --version

2. Manual Installation

# Download pre-built binary (if available)
wget https://github.com/your-repo/flx/releases/download/v1.0.0/flx-linux-x64
chmod +x flx-linux-x64
sudo mv flx-linux-x64 /usr/local/bin/flx

# Verify
flx --version

3. Docker Installation

FROM dart:stable

# Install FLX CLI
RUN dart pub global activate flx

# Add pub cache to PATH
ENV PATH="${PATH}:/root/.pub-cache/bin"

# Verify installation
RUN flx --version

🔍 Troubleshooting Tips

Debug Installation

# Verbose installation
dart pub global activate flx_cli --verbose

# Trace installation
dart pub global activate flx_cli --trace

# Check pub configuration
dart pub config

# Environment variables
env | grep -E "(DART|FLUTTER|PUB|PATH)"

System Information

# Operating system
uname -a

# Dart SDK location
which dart

# Flutter SDK location (if applicable)
which flutter

# Available disk space
df -h

# Network connectivity
curl -I https://pub.dev

✅ Prevention Tips

Regular updates: Keep Dart/Flutter SDK updated
Clean environment: Regular cache cleanup
Version control: Document working versions
Network stability: Ensure stable internet connection
Antivirus exclusions: Add pub cache to exclusions
Backup configuration: Save working environment settings

Installation সমস্যা solve না হলে: GitHub Issues এ system information সহ report করুন! 🛠️

📥 Installation Problems​

1. "Command not found: flx"​

2. "Failed to install FLX"​

3. "Permission denied"​

🖥️ Platform-specific Issues​

Windows Issues​

1. "Windows Defender blocking installation"​

2. "Path not updating on Windows"​

3. "Long path names issue"​

macOS Issues​

1. "macOS Gatekeeper blocking FLX"​

2. "Xcode Command Line Tools missing"​

Linux Issues​

1. "Dart SDK not found"​

2. "libstdc++ missing"​

🌐 Network Issues​

1. "Unable to connect to pub.dev"​

2. "Certificate verification failed"​

3. "Corporate firewall blocking"​

🔄 Version Issues​

1. "Dart SDK version incompatible"​

2. "FLX version conflict"​

3. "Flutter SDK conflict"​

🧹 Clean Installation​

Complete Cleanup and Reinstall​

Verify Installation​

🚀 Alternative Installation Methods​

1. Git Installation (Development)​

2. Manual Installation​

3. Docker Installation​

🔍 Troubleshooting Tips​

Debug Installation​

System Information​

✅ Prevention Tips​

📥 Installation Problems

1. "Command not found: flx"

2. "Failed to install FLX"

3. "Permission denied"

🖥️ Platform-specific Issues

Windows Issues

1. "Windows Defender blocking installation"

2. "Path not updating on Windows"

3. "Long path names issue"

macOS Issues

1. "macOS Gatekeeper blocking FLX"

2. "Xcode Command Line Tools missing"

Linux Issues

1. "Dart SDK not found"

2. "libstdc++ missing"

🌐 Network Issues

1. "Unable to connect to pub.dev"

2. "Certificate verification failed"

3. "Corporate firewall blocking"

🔄 Version Issues

1. "Dart SDK version incompatible"

2. "FLX version conflict"

3. "Flutter SDK conflict"

🧹 Clean Installation

Complete Cleanup and Reinstall

Verify Installation

🚀 Alternative Installation Methods

1. Git Installation (Development)

2. Manual Installation

3. Docker Installation

🔍 Troubleshooting Tips

Debug Installation

System Information

✅ Prevention Tips